Appeon DataWindow menu

Appeon DataWindow menu client functions

You can enable the Appeon DataWindow Menu by calling two Appeon client functions that are defined in the Appeon Workarounds PBL.

  1. AppeonPopMenu function

    Description

    Pops up Appeon DataWindow menu at a specified position in a specified DataWindow control.

    Syntax

    AppeonPopMenu (datawindow adw_dw, Integer nx, Integer ny)

    Argument

    Description

    adw_dw

    The DataWindow control on which you want to pop up the Appeon DataWindow menu.

    nx

    The instance from the left edge of the DataWindow control.

    ny

    The instance from the top edge of the DataWindow control.

    Return value

    None.

    Usage

    • User customized RMB menus should have a higher priority than Appeon customized menus.

    • The AppeonPopMenu function has a higher priority than the AppeonPopMenuOn function.

    • Defining your RMB menu in RButtonDown event is not recommended because this will cause the confusion in the system. To work around this, define your RMB menu in the RButtonUp event.

  2. AppeonPopMenuOn function

    Description

    Pops up Appeon DataWindow menu in a specified window when you right click the mouse button.

    Syntax

    AppeonPopMenuOn (datawindow adw_dw, Boolean ab_show)

    Argument

    Description

    adw_dw

    The DataWindow control on which you want to show the Appeon DataWindow menu.

    ab_show

    The Boolean value that decides whether to show Appeon DataWindow menu.

    • True - Enables the display of the Appeon DataWindow menu.

    • False - Disables the display of the Appeon DataWindow menu.

    Return value

    None.

    Usage

    • User customized RMB menus should have a higher priority than Appeon customized menus.

    • The AppeonPopMenu function has a higher priority than the AppeonPopMenuOn function.

    • Defining your RMB menu in RButtonDown event is not recommended because this will cause the confusion of the system. To work around this, define your RMB menu in the RButtonUp event.

How to invoke an Appeon DataWindow Menu

There are two ways to invoke an Appeon DataWindow menu:

  1. Execute the AppeonPopMenu function for a specified DataWindow.

  2. After the AppeonPopMenuOn function is executed for a specified DataWindow, right click on a DataWindow (the area clicked should not be a DataWindow field that has focus).

Note: If the area clicked is a DataWindow field that has focus, the DataWindow menu that pops up is the same as it would be in PowerBuilder, and contains the following items: Undo, Cut, Copy, Past, Delete, and Select All.

Appeon DataWindow Menu Items

Menu Items

Functionality

Find

Finds a record with user-specified text.

Find next

Finds the next record with the specified text.

Find previous

Finds the previous record with the specified text.

Sort

Displays a sort dialog for the user to specify sorting criteria and sorts the DataWindow.

Filter

Displays a filter dialog for the user to specify filtering criteria and filters the DataWindow records. This is done on the client side.

Print...

Prints the content in the DataWindow with a Client printer.

  • At the click of the Print button, a Print Setup dialog pops up with the names of all the Client printers listed for the printing job.

  • Using PDFPrinter on the Client for printing is not recommended. If the default printer on the Client is PDFPrinter, the printed result is saved to the "\My Documents\Appeon Printer" folder on the Client. By default, the PDF file that is generated is only named with the .pdf extension and will have no name. If a previously printed .pdf document resides in the "Appeon Printer" folder then it will be overwritten the next time a document is printed to the folder. If the previously printed .pdf file is open, printing of the new document will fail.