[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'Forms' (#lcl)

# TShowInTaskbar

Identifies the display preference for a form on the TaskBar.

## Declaration

Source position: forms.pp line 491

`type TShowInTaskbar = (`
`stDefault,` |  | Uses the default rules for the widgetset / platform to determine form visibility on the TaskBar.
`stAlways,` |  | Always show the form on the TaskBar.
`stNever` |  | Never show the form on the TaskBar.
`);`

## Description

TShowInTaskbar is an enumerated type with values that indicate whether a form should be displayed on the task bar for the application. TShowInTaskbar is the type used to implement the ShowInTaskBar and EffectiveShowInTaskBar properties in TCustomForm.

stDefault has a special meaning. It enables use of the setting in Application.TaskBarBehavior to determine whether one or more icon buttons can be displayed for the forms in the application. The resulting value is the effective task bar visibility for a given form.

stDefault also indicates that widgetset features and rules for form display on the task bar are used.

For Windows, it causes the Parent for the form to be set to the AppHandle in the widgetset if the form is not the MainForm in the Application. Otherwise, the MainFormHandle in the Application is used.

On QT platforms, only the MainForm for the application is visible on the task bar (single button mode) when set to stDefault.

On GTK platforms, the SkipTaskBarHint for the GDK window is set to False for the value.

Some display managers, like Cinnamon, also do not allow multiple buttons to be displayed; only the main form for the application is visible on the task bar.

The widgetset implementation may also impose restrictions based on the display protocol used at run-time, like X-11 or Wayland.

## See also

TCustomForm.ShowInTaskBar |  | Indicates if the form should be displayed on the system Task Bar.
TCustomForm.EffectiveShowInTaskBar |  | Value for the ShowInTaskBar property when resolved using the Application settings.