PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
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
Warning
From version 17, this feature is no longer available.
Displays a message containing a text, an icon and a combination of buttons.
Notes:
  • If the agent is visible, an icon is displayed in the window of the agent. The message is displayed if the user clicks this icon.
  • If the agent is invisible, the agent keeps the message and an icon will be displayed once the agent becomes visible.
Example
// Displays a message
ResChoice = AgentAdvice("Do you want to open this document?",...
        agtB_OKC + agtI_Question + agtMODALYES)
Syntax
<Result> = AgentAdvice(<Message Text> , <Message Style>)
<Result>: Integer constant
  • Return constant identifying the button selected by the user,
  • -1 if an error occurred.
The following constants are available:
agtR_OKOK
agtR_CANCELCancel
agtR_ABORTAbandon
agtR_RETRYRetry
agtR_IGNOREIgnore
agtR_YESYes
agtR_NONo
<Message Text>: Character string
Multiline text of message.
<Message Style>: Combination of Integer constants
Specifies the message style:
  • The buttons:
    agtB_OKOK
    agtB_OKCOK and Cancel
    agtB_ARIAbort, Retry, Ignore
    agtB_YNCYes, No, Cancel
    agtB_YNYes, No
    agtB_RCRetry, Cancel
  • The icons:
    agtI_HANDWhite cross, red backgroundAgentBeep: emergency stop sound
    agtI_QUESTIONQuestion markAgentBeep: interrogation sound
    agtI_EXCLAMATIONExclamation markAgentBeep: exclamation sound
    agtI_ASTERISKThe "i" of informationAgentBeep: asterisk sound
    agtI_WARNINGExclamation markAgentBeep: exclamation sound
    agtI_ERRORExclamation markAgentBeep: exclamation sound
    agtI_INFORMATIONThe "i" of informationAgentBeep: asterisk sound
    agtI_STOPExclamation markAgentBeep: exclamation sound
  • The mode:
    agtMODALYESThe message is a modal message (the application is stopped)
    agtMODALNOThe message is not modal (the application continues to run)
Components
WINDEVReports and Queries wd180agt.dll
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment