Siebel Developer's Reference > User Properties > Applet User Properties >

Specifying the Default Applet Focus

The DefaultFocus applet user properties set the focus for a field or control that resides in an applet before a user interacts with this field or control. It can override this focus behavior as determined by the applet mode. An applet web template determines the modes that an applet can use.

You can configure Siebel CRM to deactivate each of these user properties, to modify the value for each them, or to create a new instance of each of them, but you must not configure Siebel CRM to create more than one instance of each them for an applet.

Setting the Default Focus for an Object That Siebel CRM Does Not Display

If you set the default focus to a field or control that Siebel CRM does not display in the visible portion of the client, then one of the following situations might occur. This behavior might confuse the user:

• The user might not be able to identify the object that is in focus.
• Siebel CRM might attempt to adjust the vertical position of the view so that it can display the field or control that is in focus.

Specifying the Default Applet Focus for Base, Edit, or Edit List Mode

The DefaultFocus_Edit applet user property sets the focus for a field or control in an applet if the applet is in Base, Edit, or Edit List mode. The value for this user property must include the name of a field or control that resides in the applet. You must not enclose this value with quotes. For example, you can use the following value to set the default focus for the Last Name field on an applet that is in Edit mode:

Last Name

If you do not add the DefaultFocus_Edit user property to an applet, and if the applet is in Base, Edit, or Edit List mode, then Siebel CRM does not set the focus on any field or control.

Specifying the Default Applet Focus for New Mode

The DefaultFocus_New applet user property sets the focus for a field or control that resides in an applet if the applet is in New mode. The value for this user property must include the name of a field or control that resides in the applet. You must not enclose this value with quotes. For example, you can use the following value to set the default focus to the New button on an applet that the user uses to add a new record:

NewRecord

If you do not add the DefaultFocus_New user property to an applet, and if the applet is in New mode, then Siebel CRM sets the focus on the first field in the applet.

Specifying the Default Applet Focus for Query Mode

The DefaultFocus_Query applet user property sets the focus for a field or control that resides in an applet if the applet is in Query mode. The value for this user property must include the name of a field or control that resides in the applet. You must not enclose this value with quotes. For example, you can use the following value to set the default focus for the First Name field on an applet that is in Query mode:

First Name

If you do not add the DefaultFocus_Query user property to an applet, and if this applet is in Query mode, then Siebel CRM sets the focus to the first field that it displays in this applet.