PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • The different types of pages: characteristics and associated processes
  • Main page
  • Configuration page
  • Flyout page
  • WLanguage functions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Vista gadget: Programming
Overview
WEBDEV allows you to easily create gadgets for Windows Vista (and later). A gadget is a "mini site" containing specific pages.
To manage these pages and to exploit all the properties of the Vista gadgets, WEBDEV proposes:
  • specific processes associated with the different types of pages of a Vista gadget.
  • WLanguage functions used to manage some specific features of Vista gadgets.
The different types of pages: characteristics and associated processes
Three types of pages can be used in a gadget:
  • Main page (overview page).
  • Configuration page (setting page).
  • Flyout page.
These three types of pages contain specific processes.
Note: If the pages of the Vista gadget are static pages, only the browser processes are available. If the gadget pages are AWP pages, the standard server processes are added to the browser processes. See Processes associated with pages for more details.

Main page

The main page is the page displayed in the pane of gadgets in Windows Vista. The width of this page must be included between 25 and 130 pixels, and its minimum height must be equal to 60 pixels.
To create a clipped gadget, specify a background image. This image must support the transparent mode (image in GIF or PNG format for example).
This page can be used to display "Flyout" pages. To do so, GadgetDisplayFlyout must be used in the code of the relevant button.
The browser code associated with this page is as follows:
ProcessRuntime condition
Loading (onload) the page (Browser code)Browser code run when the page is displayed in the browser (performed by PageDisplay or PageRefresh for example)
Unloading (onunload) the page (Browser code)Browser code run when a new page is displayed in the browser.
Anchoring the page in the Windows pane (Browser code)Browser code run when the Vista gadget is "docked" to the gadget pane of Windows.
Exit from the page of the Windows pane (Browser code)Browser code run when the Vista gadget is "undocked" (exit) from the gadget pane of Windows.
Once the configuration window is closed (Browser code)Browser code run when closing the page used to configure the Vista gadget.
Opening the configuration window (Browser code)Browser code run when opening the page used to configure the Vista gadget.
Mouse out (Browser code)Browser code run when the mouse cursor is located outside the Vista gadget.

Configuration page

The configuration page is used to configure the Vista gadget. This page is displayed by the configuration button (tool icon) found in the gadget. This button is automatically displayed if a configuration page is found. This button cannot be configured.
The width of this page must be equal to 278 pixels.
The configuration page automatically contains a validation button and a cancelation button.
In the configuration page, a font must be specified in the styles: if the font is "not defined", the default font will be used. In this case, differences in page layout may occur between the edit mode and the runtime mode.
The background color of the configuration page is gray. This color cannot be modified. A background image can be used. If this background image manages the transparency, it is recommended not to write in the transparent areas.
The browser code associated with this page is as follows:
ProcessRuntime condition
Loading (onload) the page (Browser code)Browser code run when the page is displayed in the browser (performed by PageDisplay or PageRefresh for example)
Unloading (onunload) the page (Browser code)Browser code run when a new page is displayed in the browser.
Validating the configuration window (Browser code)Browser code run when the validation button is pressed.
Canceling the configuration window (Browser code)Browser code run when the cancelation button is pressed.
Note: GadgetLoadParameter and GadgetSaveParameter are used to store the parameters.

Flyout page

The flyout pages are standard pages. These pages are free pages that can be opened from the main page (via a button, a link, ...).
The maximum size for this type of page is equal to 400 pixels in height and in width. The background color of the flyout pages is white. This color cannot be modified.
In the flyout pages, a font must be specified in the styles: if the font is "not defined", the default font will be used. In this case, differences in page layout may occur between the edit mode and the runtime mode.
The flyout pages contain the following processes:
ProcessRuntime condition
Loading (onload) the page (Browser code)Browser code run when the page is displayed in the browser (performed by PageDisplay or PageRefresh for example)
Unloading (onunload) the page (Browser code)Browser code run when a new page is displayed in the browser.
These pages can be handled by GadgetDisplayFlyout and GadgetCloseFlyout.
WLanguage functions
The following functions are used to manage the Vista gadgets:
Versions 12 and later
GadgetCloseFlyout
New in version 12
GadgetCloseFlyout
GadgetCloseFlyout
Closes the detailed popup in a Vista gadget.
Versions 12 and later
GadgetDisplayFlyout
New in version 12
GadgetDisplayFlyout
GadgetDisplayFlyout
Displays a page of the Vista gadget.
Versions 12 and later
GadgetLoadParameter
New in version 12
GadgetLoadParameter
GadgetLoadParameter
Loads a persistent value in a gadget.
Versions 12 and later
GadgetSaveParameter
New in version 12
GadgetSaveParameter
GadgetSaveParameter
Saves a persistent value in a gadget.
See also
Minimum required version
  • Version 12
Comments
Click [Add] to post a comment