The following example makes the edit control NAME visible and activates it:

MyDialog~GetEditControl("NAME")~Show

MyDialog~GetEditControl("NAME")~Hide

MyDialog~GetEditControl("NAME")~HideFast
...
MyDialog~Update

MyDialog~GetEditControl("NAME")~ShowFast
...
MyDialog~Update

This argument can be one of the following keywords (case is not significant.) If no argument is given, the default keyword is NORMAL:

To each keyword, except the INACTIVE keyword, you can add FAST, separated by a blank, to suppress the redrawing of the dialog control.

The following statement makes a tree control in the dialog visible without redrawing it.

MyDialog~GetTreeControl(IDC_TREECONTROL_FILES)~Display("NORMAL FAST")

MyDialog~GetEditControl("Name")~Enable

MyDialog~GetEditControl("Name")~Disable

The only argument is

Negative values indicate the function failed, non-negative values indicate success.

The only argument is:

Negative values indicate the function failed, non-negative values indicate success.

The arguments are:

The following example resizes the tree view control FILES almost to the size of the window and displays the new size:

obj = MyDialog~GetTreeControl("FILES")
if obj = .Nil then return
obj~Resize(MyDialog~SizeX -10, MyDialog~SizeY -20)
parse value obj~GetSize with width height
say "New width of window is" width "and new height is" height

The arguments are:

The following example repositions the tree view control FILES to the upper left corner of the window and displays the new position:

obj = MyDialog~GetTreeControl("FILES")
if obj = .Nil then return
obj~Move(1,1)
parse value obj~GetPos with x y
say "New horizontal position of window is" x "and new vertical position is" y

The only argument is:

The handle to the previous foreground window, or 0 if this method failed.

This example makes another dialog the foreground window and returns the window handle of the current foreground window to the caller, or returns -1 if there was an error:

::method switchToReportDlg
  expose reportDlg
  currentHwnd = self~setForeGroundwindow(reportDlg~dlgHandle)
  if currentHwnd == 0 then return -1  -- Report an error
  return currentHwnd

The handle to the foreground window, or 0 if this method failed.

The numeric ID.

The following example displays 1 in most cases:

say MyDialog~GetButtonControl("IDOK")~GetID

A negative return indicates an error.

The following example gets the style flags for a tree control and then checks to see if drag and drop is enabled and if label editing is enabled.

The value of the style flags has the potential of being larger than can be accommodated by the default numeric digits. Use numeric digits 11 if the returned value needs to be manipulated, for instance to use d2x on the value.

  ...

  numeric digits 11
  TVS_DISABLEDRAGDROP = "0x0010"
  TVS_EDITLABELS      = "0x0008"

  treeControl = self~getTreeControl(IDC_TREE)
  style = treeControl~getStyleRaw
  style = "0x" || style~d2x~right(8, '0')

  if BinaryAnd( style, TVS_DISABLEDRAGDROP ) <> 0 then str1 = 'disabled'
  else str1 = 'enabled'

  if BinaryAnd( style, TVS_EDITLABELS ) <> 0 then str2 = 'enabled'
  else str2 = 'disabled'

  say 'Tree-view Control styles'
  say '  Raw style:    ' style
  say '  Drag and drop:' str1
  say '  Edit labels:  ' str2

/* Output coule be: */

Tree-view Control styles
  Raw style:     0x5000002F
  Drag and drop: enabled
  Edit labels:   enabled

The coordinates of the dialog or dialog control, separated by blanks.

The following example calculates the width and height of an entry line:

parse value MyDialog~GetEditControl("Name")~GetRect with left top,
right bottom
width = right - left
height = bottom - top

The arguments are:

The only argument is:

The client rectangle in the format "left top right bottom", separated by blanks.

The horizontal and vertical position, separated by a blank.

For an example, see Move.

The width and height, separated by a blank.

For an example, see Resize.

The handle to the dialog control that has the input focus, or 0 if this method failed.

The only argument is:

The only argument is:

The arguments are:

The following example sets the background color of list box FILES to blue:

MyDialog~GetListBox("FILES")~SetColor(4, 15)

The only argument is:

The following example changes the label of radio button CHOICE2:

MyDialog~GetRadioControl("CHOICE2")~Title="&Object Rexx (preferred choice)"
MyDialog~Redraw