PureBasic WebGadget — Procedures

WebGadget Procedures (4)

Cr_WebGadget

Embeds a WebGadget / WebViewGadget into a ContainerGadget allowing for borders.

• url:
  • Validates the URL; if not valid, default HTML code is used.
• flags:
  • #CrWG_WebView_Gadget
  • #CrWG_WebView_Inspect (same as #PB_WebView_Debug)
  • #Cr_WebGadget_BorderLess
  • #Cr_WebGadget_Flat
  • #Cr_WebGadget_Raised
  • #Cr_WebGadget_Single
  • #Cr_WebGadget_Double

Cr_WebGadget(gadget, x, y, width, height, url.s = #Null$, flags = #Cr_WebGadget_BorderLess)

Cr_WebGadget_Resize

Resizes both the ContainerGadget and embedded WebGadget / WebViewGadget in a single call.

Cr_WebGadget_Resize(gadget, x, y, width, height)

Cr_WebGadget_SetHTML

Loads a WebGadget / WebViewGadget with HTML code.

• SetGadgetItemText is used with the flag #PB_WebView_HtmlCode.
• html:
  • If not set, default HTML code is used.
• local = #True:
  • Saves the HTML code to a temporary file.
  • Uses SetGadgetText with the file:// protocol.
  • Returns the file path for deletion before program termination.

Cr_WebGadget_SetHTML(gadget, html.s = #Null$, local = #False)

Cr_WebGadget_SetURL

Navigates a WebGadget / WebViewGadget to the specified URL.

• Uses SetGadgetText.
• Validates the URL or falls back to default HTML code.

Cr_WebGadget_SetURL(gadget, url.s)

WebSocket Procedures (3)

Cr_WebSocket_Close

Attempts to cleanly end the running program.

• HideWindow: Set to the #Window Number of the main window (useful if the window does not close immediately).

Cr_WebSocket_Close(HideWindow = #Null)

Cr_WebSocket_Connect

Establishes a network connection to the Chrome DevTools Protocol (CDP) API.

• PageID: Retrieved using the procedure Cr_WebSocket_PageData.
• PortNumber: Optional; use only for specific needs.

Cr_WebSocket_Connect(PageID.s, PortNumber.l = #Null)

Cr_WebSocket_PageData

Extracts page data from a JSON string into a structured List.

• The JSON string is updated via the network connection.
• Whenever a webpage changes, the JSON data is refreshed accordingly.

Cr_WebSocket_PageData(*PageData, List PageData.PAGE_DATA())

PureBasic Procedures (3)

ConvertBase64

Returns a PureBasic image created from a Base64-encoded string.

• The Base64 string must not include any header data.

ConvertBase64(Base64_Image.s)

GenerateUUID

Generates and returns a random GUID (Globally Unique Identifier), also known as a UUID.

GenerateUUID()

ValidateURL

Validates a URL and returns it if valid; otherwise, returns an empty string.

ValidateURL(URL.s)