Back to Devexpress

TdxRibbonBackstageViewGalleryItem.Pinned Property

vcl-dxribbonbackstageviewgallerycontrol-dot-tdxribbonbackstageviewgalleryitem-429a2153.md

latest1.9 KB
Original Source

TdxRibbonBackstageViewGalleryItem.Pinned Property

Switches the item’s pinned state.

Declaration

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

Property Value

TypeDefault
BooleanFalse

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

TdxRibbonBackstageViewGalleryItem Class

TdxRibbonBackstageViewGalleryItem Members

dxRibbonBackstageViewGalleryControl Unit