ShowAdvancedPrompt

Use this Longview Application Framework function in a procedure document to display a customizable prompt that returns a value based on a user’s selection. You can use ShowAdvancedPrompt to specify the following:

• Message icon
• Caption
• Message text
• Up to five Buttons, including button text and return values
• The button with focus by default

  

Example: Advanced Prompt

This function is specific to Longview Apps. The window title of messages and prompts is specified in your .lvapp file with the <description> parameter. The look and feel of messages and prompts is specified in your .lvapp file with the <theme> parameter. For more information, see Configuring Longview Apps.

Note: You must use the ShowAdvancedPrompt function with Set Variable to set the value to the variable to which the function will be returning data. See the syntax example below. You cannot use the ShowAdvancedPrompt function in batch mode.

Syntax:

where:

• MessageType determines the icon to display and can be one of the following values:
  • Error
  • Information
  • Warning
  • Question
  • None
• Caption is the main title text of the message prompt, enclosed in double quotation marks. To omit this parameter, use two double quotation marks ( "" ).
• Message is mandatory and is any additional information to include, enclosed in double quotation marks.
• DEFAULT specifies the button that has focus by default when the message prompt opens. If you do not specify DEFAULT for any button, the first button listed has focus when the message prompt opens.
• ButtonText is mandatory and is the text to display on the button. You must specify at least one button. You can optionally specify up to five buttons in your prompt.
• ButtonValue is the return value if the user selects the button. If no value is specified, ButtonText is the return value.

Syntax example: