SHOW GET

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

To redisplay the specified 'get' object or call a 'get' method


Syntax

SHOW GET <expN1> | <expC1> [, <expN2> [PROMPT <expC2>]]

[COLOR SCHEME <expN3>] | [COLOR <expC3>]

[ENABLE | DISABLE]

[LEVEL <expN4>]

[PROPERTIES <expC4>]


See Also

@...GET, READ, SHOW GETS, SHOW OBJECT


Description

The SHOW GET command is used to update the screen display for a specific get or to call a get method. If the value of a get is changed without user intervention, for example via a validation function, the SHOW GET command can be used to redisplay the altered value on the screen. The <expN1> is the number of the get based on its screen position. The numbers start at 1 for the top left-hand get. The get can also be specified using a character expression, <expC1>, that returns the variable or field name of the get.

PROMPT <expC2>

Where the specified get is a pushbutton, radio button or check box, the PROMPT clause can be used to change the current prompt of the get. The new prompt is specified in <expC2>.

COLOR SCHEME <expN3> | COLOR <expC3>

The COLOR SCHEME | COLOR clause is used to update the foreground and background colors of the specified get. The <expN3> is the number of a color scheme. The <expC3> is a color pair in the format foreground / background.

ENABLE | DISABLE

The ENABLE keyword enables the get, allowing it to be modified or selected, whereas the DISABLE keyword disables the get and it cannot be modified or selected.

LEVEL <expN4>

The LEVEL clause can be used to specify the level number of the READ, <expN4>. SHOW GET defaults to the current READ level.

PROPERTIES <expC4> (Recital Mirage only)

The PROPERTIES clause can be used to either specify properties for the specified get or to call one of its methods. For information on the properties and methods appropriate to each object, please see The Mirage Object Model in the Recital Mirage documentation.


Example

function v_button
  do case
  case mbutton = 1
      show get 1 properties "method=moveNextPage"
  case mbutton = 2
      show get 1 properties "method=movePreviousPage"
  case mbutton = 3
      dialog message "Do you want to quit the Mirage demo?"
      if lastkey() == 89
          show get 2 properties "method=quit"
          quit
      endif
  case mbutton = 4
      printFile("c:Program filesRecitalUASMirageMirage_demomirage_demo.prg" + ;
        "?tabs=4&topMargin=50&autoNumber=true", ;
        "{FILE},,{DATE}",",-- Page {PAGE} --,")
  endcase
return .T.


Products

Recital