Syntax

DlgText {ControlName$ | ControlIndex}, NewText$

Description

Changes the text content of the specified control.

Comments

The effect of this statement depends on the type of the specified control:

Control Type

Effect of Dlg Text

Picture

Runtime error.

Option group

Runtime error.

Drop list box

Sets the current selection to the item matching NewText$. If an exact match cannot be found, the DlgText statement searches from the first item looking for an item that starts with NewText$. If no match is found, then the selection is removed.

OK button

Sets the label of the control to NewText$.

Cancel button

Sets the label of the control to NewText$.

Push button

Sets the label of the control to NewText$.

List box

Sets the current selection to the item matching NewText$. If an exact match cannot be found, the DlgText statement searches from the first item looking for an item that starts with NewText$. If no match is found, then the selection is removed.

Combo box

Sets the content of the edit field of the combo box to NewText$.

Text

Sets the label of the control to NewText$.

Text box

Sets the content of the text box to NewText$.

Group box

Sets the label of the control to NewText$.

Option button

Sets the label of the control to NewText$.

The ControlName$ parameter contains the name of the .Identifier parameter associated with a control in the dialog box template. A case-insensitive comparison is used to locate the specific control within the template. Alternatively, by specifying the ControlIndex parameter, a control can be referred to using its index in the dialog box template (0 is the first control in the template, 1 is the second, and so on).

Example

Sub Main()

  DlgText "GroupBox1","Save Options"     'Change text of group box 1.

  If DlgText$(9) = "Save Options" Then
    DlgText 9,"Editing Options"      'Change text to "Editing Options".
  End If
End Sub

See Also

DlgEnable (function); DlgEnable (statement); DlgFocus (function); DlgFocus (statement); DlgListBoxArray (function); DlgListBoxArray (statement); DlgSetPicture (statement); DlgText (statement); DlgValue (statement); DlgValue (function); DlgVisible (statement); DlgVisible (function).

D