Description

Sets the text on the user control that is specified by userControlId.

Each user control has its own text which is usually displayed with the control. This text is not to be confused with tooltip text, which only gets displayed when a user hovers the mouse over the user control. For text boxes, the control text is what the user edits. For other user control types, the text is for display only.

Some user controls, like color pickers, don't have any visible text, so this command doesn't have any effect on them. All user controls have no text by default, unless it is created using the -text option.

Functional area

User Window

Command syntax

Syntax

setControlText userControlID "controlText"

Arguments

Name	Type	Required	Comments
`controlText`	string	yes	Text to set for the user control
`userControlId`	int	yes	ID of user control to set text for.

Flags

None

Return value

void

Examples

// Set the text of a control.
int $windowId; 
int $controlId;
 
// First create a User Window to place the Control on
$windowId = `createWindow "MyWindow"`;
 
// Create a Text Box Control in the window.
$controlId = `createTextBox $windowId`;
 
// Set the text
setControlText $controlId "Some Text";

Additional information

Related commands

Browser not supported