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

DefaultFocus User Properties


These applet user properties set the field or control within an applet that receives focus by default, that is, before a user interacts to dynamically change the field or control with focus. This user property is provided to allow overriding the field or control that receives default focus as determined by the applet's mode. The modes in which an applet can be deployed are defined in the Object Explorer, Applets, and then Applet Web Templates object.

CAUTION:  If you set default focus to a field or control that is off the screen, one of two things may happen:

  • The user may not know where focus is.
  • The application may try to adjust the vertical position of the view to try to show the in-focus field or control. In either case, the behavior may be disruptive to end users.

DefaultFocus_Edit

This applet user property sets the field or control within an applet that receives focus when the applet is in Base, Edit, or Edit List mode.

Value

The name of a field or control on the applet, not enclosed in quotes.

Usage

For example, this user property could be set to Last Name to give default focus to the Last Name field on an applet in Edit mode.

If the DefaultFocus_Edit user property is not added to an applet, then no field or control typically is default focus when the applet is in Base, Edit, or Edit List mode.

You can inactivate this user property or modify its value. You can create new instances of this user property, but do not create more than one instance for an applet.

Parent Object Type

Applet

Functional Area

User interface

DefaultFocus_New

This applet user property sets the field or control within an applet that receives focus when the applet is in New mode.

Value

The name of a field or control on the applet, not enclosed in quotes.

Usage

For example, this user property could be set to NewRecord to give default focus to the New button on an applet being used to add a new record.

If the DefaultFocus_New user property is not added to an applet, then the first field in the applet typically is default focus when the applet is in New mode.

You can inactivate this user property or modify its value. You can create new instances of this user property, but do not create more than one instance for an applet.

Parent Object Type

Applet

Functional Area

User interface

DefaultFocus_Query

This applet user property sets the field or control within an applet that receives focus when the applet is in Query mode.

Value

The name of a field or control on the applet, not enclosed in quotes.

Usage

For example, this user property could be set to First Name to give default focus to the First Name field on an applet in Query mode.

If the DefaultFocus_Query user property is not added to an applet, then the first field in the applet typically is default focus when the applet is in Query mode.

You can inactivate this user property or modify its value. You can create new instances of this user property, but do not create more than one instance for an applet.

Parent Object Type

Applet

Functional Area

User interface

Siebel Developer's Reference Copyright © 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices.