Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

AlertControl.ShowPinButton Property

Gets or sets whether the Pin button must be displayed in newly created alert windows.

Namespace: DevExpress.XtraBars.Alerter

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

[DefaultValue(true)]
[DXCategory("Appearance")]
public virtual bool ShowPinButton { get; set; }

#Property Value

Type Default Description
Boolean true

true if the Pin button must be displayed in newly created alert windows; otherwise, false.

#Remarks

An alert window can display the Close, Pin and Dropdown control buttons. The availability of these buttons is specified by the AlertControl.ShowCloseButton, ShowPinButton and AlertControl.PopupMenu properties, respectively. The position of the control buttons is specified by the AlertControl.ControlBoxPosition property.

Clicking the Pin button forces an alert window to stay on-screen until the button is clicked again. If the window is unpinned and the mouse cursor doesn’t hover over the window for a specific time, the window is automatically destroyed.

It’s also possible to display custom buttons in alert windows. To do this, add items to the AlertControl.Buttons collection.

AlertWindow_Buttons

Changing the ShowPinButton option is not in effect for existing alert windows. The option is applied to newly created windows.

See Also