LabWindows/CVI 2017 Help

Edition Date: May 2017

Part Number: 370051AG-01

»View Product Info

DOWNLOAD (Windows Only)
LabWindows/CVI 2010 Help
LabWindows/CVI 2012 Help
LabWindows/CVI 2013 Help
LabWindows/CVI 2015 Help
LabWindows/CVI 2017 Help

int InstallPopup (int panelHandle);


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 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.


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


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


Not Helpful