NavElement.Glyph Property

Gets or sets the NavElement's glyph when the NavElement is rendered as a button in the TileNavPane's nav bar.

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

[Browsable(false)]
[DefaultValue(null)]
[DXCategory("Appearance")]
public virtual Image Glyph { get; set; }
<Browsable(False)>
<DefaultValue(Nothing)>
<DXCategory("Appearance")>
Public Overridable Property Glyph As Image

Property Value

Type Default Description
Image

null

The element's glyph displayed within the nav bar.

Remarks

The Glyph property is in effect for NavElement objects rendered as buttons in the TileNavPane's nav bar. The NavElement.GlyphAlignment property allows you to specify the glyph alignment within the button. The button's text is specified by the NavElement.Caption property.

When a NavElement is rendered as a tile, the image displayed in the tile is specified by the TileNavElement.TileImage property. The tile's text can be specified with the TileNavElement.TileText property.

If your application is DPI-aware (see WindowsFormsSettings.SetDPIAware), button glyphs are automatically scaled to match the current monitor's DPI setting. This allows your UI to look consistent on displays with different DPI settings. However, instead of scaling glyphs, which leads to poorer quality of images than it supposed to be on high-DPI monitors, you can provide a stack of images with different DPI settings, using the DPI-aware ImageCollection. When the DPI-aware ImageCollection is used, the appropriate image is automatically selected based on the current monitor's DPI setting. See the ImageCollection.IsDpiAware property for details. If you use a DPI-aware image collection, set the TileNavPane.ScaleGlyphs property to false to prevent the glyphs from being automatically scaled.

See Also