This base class can be used to create buttons that appear in the tray area of every MapView and ArcGIS.Desktop.Layouts.LayoutView. It provides virtual methods that can be overriden to perform actions during the life cycle of this button.

Specify the type of desired button by setting ButtonType within either an overridden constructor or Initialize. After Initialize has been invoked, the underlying UI Button will be fixed for the lifetime of the associated view.

If ButtonType has been set to TrayButtonType.Button then ClickCommand should also be set - it will be invoked whenever the UI button is clicked.

If ButtonType has been set to TrayButtonType.ToggleButton then OnButtonChecked will be invoked whenever the UI button's Checked state is changed.

If ButtonType has been set to TrayButtonType.PopupToggleButton then OnButtonChecked will be invoked whenever the UI button's Checked state is changed. In addition, a customizable popup window will be displayed whenever the mouse is hovered over the button. Override ConstructPopupContent to provide the content that will be displayed in the popup.

To add to the tray of a MapView, add a TrayButton component to the "esri_mapping_MapTrayButtons" category within DAML.

To add to the tray of a LayoutView, add a TrayButton component to the "esri_layouts_LayoutTrayButtons" category within DAML.

A sample UpdateCategory needs to be presented here.

Here is a copy of the Snapping InsertCategory.

<insertCategory id="esri_mapping_MapTrayButtons">
  <component id="esri_mapping_SnappingTrayButton" className="ArcGIS.Desktop.Internal.Mapping.Controls.SnappingControl.SnappingTrayButton">
      <content L_name="Snapping"
      largeImage="pack://application:,,,/ArcGIS.Desktop.Resources;component/Images/ContentsWindowListBySnapping32.png"
      smallImage="pack://application:,,,/ArcGIS.Desktop.Resources;component/Images/ContentsWindowListBySnapping16.png"
      L_tooltipHeading="Snapping"
      L_tooltip="Turn snapping on or off for interactive tools." />
  </component>
</insertCategory>

System.Object
   ArcGIS.Desktop.Framework.Contracts.PropertyChangedBase
      ArcGIS.Desktop.Framework.Contracts.ViewModelBase
         ArcGIS.Desktop.Mapping.TrayButton
            ArcGIS.Desktop.Layouts.LayoutTrayButton
            ArcGIS.Desktop.Mapping.MapTrayButton

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

TrayButton Members
ArcGIS.Desktop.Mapping Namespace