company logo

GUIBaseContext :: decision - Get decision dialog

The function displays a decision box with the selected button combination ( eReplyButtons ) buttons. One of the reply buttons can be set as default button ( eDefaultButton ). The text displayed in the decision box is taken from the string or constructed from a message resource.

Return value:  State of function return ( bool  )

A State true indicates, that the function was executed successfully. Otherwise state is false .

Implementation details

  1. Display Decision from message resource
    bool GUIBaseContext  :: decision ( int32 iMessageNumber, int32 eReplyButtons, odaba::ButtonTypes eDefaultButton, odaba::String &sParameter1, odaba::String &sParameter2, odaba::String &sParameter3 )

    The function creates the decision text from a message resource defined in the resource database. The function locates the message resource identified by the message number iMessageNumber and replaces message variables by parameters passed in sParameter1 ... sParameter3 .

    When passing iMessageNumber 0 or with an undefined value, parameters are combined to a message, directly.

    • iMessageNumber - Message number

      The message number passed refers be an error/message definition the resource database.

    • eReplyButtons - Reply buttons

      Reply buttons are a combination of default buttons provided within a decision dialog.

    • eDefaultButton - DefaultButton

      The reply type refers to the button to be selected as default button in a decision box or as default answer in a command line prompt.

    • sParameter1 - String parameter
    • sParameter2 - String parameter
    • sParameter3 - String parameter
  2. to list
  3. Display decision from text
    bool GUIBaseContext  :: decision ( odaba::String &sText, int32 eReplyButtons, odaba::ButtonTypes eDefaultButton )

    The desision box displays the message passen in sText .

    • sText - Text string
    • eReplyButtons - Reply buttons

      Reply buttons are a combination of default buttons provided within a decision dialog.

    • eDefaultButton - DefaultButton

      The reply type refers to the button to be selected as default button in a decision box or as default answer in a command line prompt.

  4. to list