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

TdxRibbonBackstageViewGalleryItem.Pinned Property

Switches the item’s pinned state.

#Declaration

Delphi
property Pinned: Boolean read; write; default False;

#Property Value

Type Default
Boolean False

#Remarks

This property is in effect when the gallery’s OptionsView.Item.PinMode property is set to bgipmTag or bgipmButton.

You can hide the item’s pin via the AllowChangePinnedState property. To respond to clicking pins, handle the Backstage View gallery’s OnItemPinClick event.

The following code sample shows how to create a new gallery item and pin it to the top of a Ribbon Backstage View group called galleryGroup1.

Delphi
with galleryGroup1.Items.Add do
  begin
    Index := 0;
    Caption := 'My Document';
    Pinned := True;
  end;

The default value of the Pinned property is False.

See Also