InstallPopup
- Updated2023-02-21
- 2 minute(s) read
int InstallPopup (int panelHandle);
Purpose
Displays and activates a panel as a modal dialog box.
You must call this function from the thread in which you create the panel.
While the modal dialog box is visible, the user cannot operate any other panels that you created in the same thread.
 |
Note While you can pass a child panel to this function, it is not recommended. Although the panel will retain its status as a child panel, it will not behave like one while it is modal, which might produce unpredictable results elsewhere in your program. |
Parameters
| Input | ||
| Name | Type | Description |
| panelHandle | int | Specifier for a particular panel that is currently in memory. You can obtain this handle from functions such as LoadPanel and NewPanel. |
Return Value
| Name | Type | Description |
| status | int | Return value indicating whether the function was successful. A negative number indicates that an error occurred. |
Additional Information
Library: User Interface Library
Include file: userint.h
LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later
Examples
Refer to the following examples that use the InstallPopup function:
- apps\uirview\uirview.cws
Open example - userint\clipbord.cws
Open example - userint\colview.cws
Open example