PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Creating a custom popup menu
  • Creating a custom popup menu
  • Other creation modes
  • Limits
  • Associate a custom popup menu with an element
  • How to proceed?
  • Special case: Popup menu of a Table control
  • Notes
  • List the available custom popup menus
  • Edit a custom popup menu
  • Deleting a custom popup menu
  • Handling a custom popup menu by programming
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
Overview
The custom popup menus are created in the window editor and they can be handled by programming.
You have the ability to create custom popup menus and to associate these popup menus:
  • with one or more controls found in a window.
  • with a window.
Notes:
  • WINDEVWindows Mobile If a popup menu of AAFs is available for this control or for this window, you can:
    • display this menu of AFFs (or some of the options).
    • display the custom popup menu before or after the popup menu of AAFs.
    • display the custom popup menu only.
  • Versions 20 and later
    iPhone/iPad The popup menu adapts to the device used.
    • on iPhone, the popup menu is displayed at the bottom of the screen:
      Popup menu on iPhone
    • on iPad, the popup menus can be displayed anywhere:
      Popup menu on iPad
    New in version 20
    iPhone/iPad The popup menu adapts to the device used.
    • on iPhone, the popup menu is displayed at the bottom of the screen:
      Popup menu on iPhone
    • on iPad, the popup menus can be displayed anywhere:
      Popup menu on iPad
    iPhone/iPad The popup menu adapts to the device used.
    • on iPhone, the popup menu is displayed at the bottom of the screen:
      Popup menu on iPhone
    • on iPad, the popup menus can be displayed anywhere:
      Popup menu on iPad
This help page explains how to:
Versions 20 and later
WINDEV MobileiPhone/iPad The custom popup menus are now available for the iPhone/iPad applications.
New in version 20
WINDEV MobileiPhone/iPad The custom popup menus are now available for the iPhone/iPad applications.
WINDEV MobileiPhone/iPad The custom popup menus are now available for the iPhone/iPad applications.
Versions 21 and later
WINDEVWINDEV MobileUniversal Windows 10 App The custom popup menus are now available in Universal Windows 10 App mode.
New in version 21
WINDEVWINDEV MobileUniversal Windows 10 App The custom popup menus are now available in Universal Windows 10 App mode.
WINDEVWINDEV MobileUniversal Windows 10 App The custom popup menus are now available in Universal Windows 10 App mode.
Creating a custom popup menu

Creating a custom popup menu

To create a custom popup menu:
  1. Select "Insert .. New popup menu". The window for editing the new custom popup menu is opened.
    Editor of popup menus
    On the "Window" pane, in the "Bars and menus" group, expand "Popup menus" and select "New popup menu". The window for editing the new custom popup menu is opened.
    Editor of popup menus
  2. Modify (if necessary) the description of the popup menu (name of popup menu, ...:
    • Display the popup menu of the option of the home window (right mouse click in the home window).
    • Select "Description of popup menu". You can:
      • Modify the name of the custom popup menu.
      • WINDEV Specify whether the menu must use the system style.
      • AndroidiPhone/iPadUniversal Windows 10 App specify the caption of the popup menu.
      • AndroidUniversal Windows 10 App Specify whether the popup menu must be moved in the action bar.
  3. Add menu options into the new popup menu. See Handling the menu options for more details.

Other creation modes

You also have the ability to create a custom popup menu:
  • from the "GUI" tab of the description of a window or window control. To do so, click the arrow on the right of the "Popup Menu" combo box and select "Create a new popup menu" . The window for editing the new custom popup menu is opened. This popup menu will be automatically associated with the current element (or with all the elements in case of multi-selection).
    =Creating a popup menu
  • from the "Management of popup menus" window. All you have to do is click the "New" button and enter the name of the new popup menu.
    Note: To open the "Management of popup menus" window, select "Windows .. Popup menu .. Edit".Note: To open the "Management of popup menus" window, on the "Window" pane, in the "Bars and menus" group, expand "Popup menus" and select "Edit".

Limits

  • AndroidiPhone/iPad The popup menus can have a single menu level. The sub-menus cannot be used.
  • iPhone/iPad Specific limits:
    • The separators are not available.
    • The checkmarks displayed before the options are not available.
    • The background color and the text color cannot be modified by ..Color and ..BrushColor.
    • ..Grayed makes the options invisible.
  • Android Specific limits:
    • The separators are not available.
    • The icons displayed before the options are not available.
    • The background color and the text color cannot be modified by ..Color and ..BrushColor.
Associate a custom popup menu with an element

How to proceed?

To associate an existing custom popup menu with one or more elements (window or controls):
  1. Select the elements that must be associated with an existing popup menu.
  2. Display the "GUI" tab in the description window of the current elements ("Description" from the popup menu).
  3. The "Popup Menu" control is used to configure the popup menu:
    • the Icon for creating a popup menu button is used to create a new popup menu.
    • the combo box is used to:
      • display the popup menu of the AAF and configure the options that will be displayed for the current control.
      • display a custom popup menu. This popup menu can replace the popup menu of AAFs or it can be displayed before or after the popup menu of AAFs.
  4. Validate.
Notes:
  • To edit the selected custom popup menu, click the Icon for editing a popup menu button found on the right of the "Popup Menu" control and select "Edit this popup menu".
  • To associate a window or a control with an existing custom popup menu by programming, use ..PopupMenu.
  • WINDEVWindows Mobile See Configuring the menus of AAFs for more details.

Special case: Popup menu of a Table control

  • If different popup menus are associated with a Table control and with its columns, the popup menu associated with the columns will have priority. When a right click is performed on a column, only the popup menu associated with the column will be displayed.
  • If all the columns of a Table control are associated with one or more popup menus, the popup menu associated with this control will never be displayed.
  • The popup menu of AAFs associated with a column of a Table control corresponds to the menu with the Table control. The options of this menu cannot be configured.

Notes

  • A custom popup menu can be associated with the controls found in a window (including Table control columns) and with the windows.
  • A custom popup menu cannot be associated with the following elements:
    • Static control,
    • non-clickable Image control,
    • Progress Bar control,
    • Shape control,
    • menu option.
  • When performing a Drag and Drop of a window control toward a window, the characteristics of the copied control will be kept. If the copied control is associated with a custom popup menu, the custom popup menu will be available in the two windows.
List the available custom popup menus
The option "Windows .. Popup menu .. Edit" is used to find out all the custom popup menus available in a window. These popup menus can be associated with this window or with the controls found in this window.To find out all the custom popup menus available in a window, on the "Window" pane, in the "Bars and menus" group, expand "Popup menus" and select "Edit". These popup menus can be associated with this window or with the controls found in this window.
Edit a custom popup menu
A popup menu can be edited via one of the following methods:
  • select "Windows .. Popup menu .. <NamePopupMenu>".on the "Window" pane, in the "Bars and menus" group, expand "Popup menus" and select "<NamePopupMenu>".
  • from the "GUI" tab in the description of a window or control associated with this popup menu:
    • Select the popup menu to edit from the "Popup Menu" combo box.
    • Click the Icon for editing a popup menu button found on the right of the "Popup Menu" control and select "Edit this popup menu".
  • from the "Management of popup menus" window:
    • Select the popup menu to edit.
    • Click the "Edit" button.
Notes:
  • See Handling the menu options in the editor for more details.
  • To access the different popup menus currently edited for a window:
    1. Click the button corresponding to the requested window in the bar of opened documents.
    2. Select the element (window or popup menu) to display.
      Access the opened popup menus
Deleting a custom popup menu
To delete a custom popup menu:
  1. Select "Window .. Popup menu .. Edit".On the "Window" pane, in the "Bars and menus" group, expand "Popup menus" and select "Edit".
  2. Select the custom popup menu to delete.
  3. Click the "Delete" button. The window and/or the controls associated with the deleted popup menu will no longer be associated with a custom popup menu. For the controls that include a default system popup menu (menu of AAF), this system popup menu will replace the deleted custom popup menu.
Handling a custom popup menu by programming
The following functions and properties are used to handle the custom popup menus by programming:
..PopupMenuUsed to find out and change the custom popup menu associated with a control or with a window. Also used to:
  • associate (or not) a control with a popup menu.
  • display (or not) the default system popup menu.
ControlPopupOwnerIdentifies the control onto which a custom popup menu was opened (to be used in the code of the custom popup menu).
OpenPopupMenuUsed to automatically open the popup menu of a control or window. You have the ability to choose the popup menu to open as well as its position.
Note: You also have the ability to handle the menu options by programming.
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment