Siebel Object Interfaces Reference > Interfaces Reference > Control Methods >

SetProperty Method


The SetProperty method sets visual properties of a control.

Syntax

controlVar.SetProperty(propName, propValue)

Argument
Description

propName

The name of the property to be set, as described in the following table

propValue

The value to assign to the property, as described in the following table

Returns

Not applicable

Usage

SetProperty can be used with the following controls: CheckBox, ComboBox, TextBox, and TextArea.

If more than one property is to be set, each must be set in a separate statement.

The following table lists the properties that can be set for a control, and the values that can be assigned to them:

Property
Value
Description

BgColor

string

Determines background color for a label; for example, red is "#ff0000", green is "#00ff00", and blue is "#0000ff"

Enabled

TRUE or FALSE

Is the button active? (Unless explicitly modified by using SetProperty, default is TRUE.)

FontColor

string

Determines font color for a label; for example, green is "#00ff00"

FontType

string

Determines font type for a label; for example, "Times Roman"

FontSize

string

Determines font size for a label; for example, "12 pt"

FontStyle

string

Determines font style for a label; for example, "italic"

Height

string

Determines height for a control, in pixels; for example, "5"

Shown

TRUE or FALSE

Is the control shown? (Unless explicitly modified by using SetProperty, default is as defined in the repository.)

ReadOnly

TRUE or FALSE

Determines whether the control is read-only. Defaults to repository definition unless explicitly modified by using SetProperty.

Visible

TRUE or FALSE

Determines whether the control is visible. Defaults to repository definition unless explicitly modified by using SetProperty.

Width

string

Determines width for a control, in pixels; for example, "80"

Used With

Browser Script

Example

The following code shows the use of SetProperty:

objCheckBox.SetProperty("FontColor", "#00ff00");
objCheckBox.SetProperty("FontStyle", "italic");
objCheckBox.SetProperty("FontType", "Verdana");
objCheckBox.SetProperty("FontSize", "14 pt");
objCheckBox.SetProperty("BgColor", "#00f000");
objCheckBox.SetProperty("Width", "100");
objCheckBox.SetProperty("Height", "100");

Siebel Object Interfaces Reference Copyright © 2008, Oracle. All rights reserved.