TCustomForm.EffectiveShowInTaskBar

Value for the ShowInTaskBar property when resolved using the Application settings.

Declaration

Source position: forms.pp line 787

Description

EffectiveShowInTaskBar is a read-only TShowInTaskBar property. It contains the effective visibility for the form on the system task bar. The value is derived from the ShowInTaskBar property when it has been changed. It is not updated, however, for the following conditions:

• The form instance is the MainForm in the Application.
• The form does not have a valid Handle.
• The form has an assigned Parent.
• The form is a MDIChild form (FormStyle is fsMDIChild).
• The form is not Showing (Handle is visible).

EffectiveShowInTaskBar resolves the value to the TaskBarBehavior property in the Application singleton. For the TaskBarBehavior values:

tbSingleButton

Contains stNever.

tbMultiButton

Contains stAlways.

tbDefault

Contains stDefault and causes the rules for the widgetset or platform to be used.

The property value is passed to the widgetset class where it may be translated, applied, or ignored based on the capabilities for the implementation or platform.

See also