FindControl Method for an Applet

The FindControl method returns a reference to the user interface control. This applet must be part of the view that Siebel CRM displays.

Format

Applet.FindControl(controlName)

The following table describes the arguments for the Browser Script format of the FindControl method.

Argument	Description
controlName	Literal string or string variable that contains the name of the control.

Usage

The FindControl method does not do the following:

• Locate a control in an MVG applet, pick applet, associate applet, or detail applet. In Siebel Tools, these applets do not appear in the child View Web Template Items list of the view.

• Locate list columns in a list applet.

  Note: User interface controls which are exposed in the UI (as a control mapped in the web template) for the applet are eligible to be referenced by FindControl. Any control, such as List, that doesn't have an appropriate HTML type configured, will not be retrieved through FIndControl. FindControl returns null in this case.

Used With

Browser Script

Examples of Using the FindControl Method

The following example is in Browser Script:

function Applet_PreInvokeMethod (name, inputPropSet)
   {
   // Code to modify the Font Size of the "Location" label
   if (name == "fontsize")
      {
      // Use FindControl() to get a reference to the control
      var ctl = this.FindControl("Location");

      ctl.SetLabelProperty("FontSize", "22"); // Set the font size
      return ("CancelOperation");
   }
}

To use this example, see SetLabelProperty Method for a Control.