Skip to main content
All docs
V25.1
  • Add Alternative Text for Image and Bound Image Items in WinForms

    To ensure that your dashboard is accessible, specify alt text for image items: ImageDashboardItem and BoundImageDashboardItem. Screen readers identify image items as follows: “{alt text} pane”.

    Both Image and Bound Image dashboard items display alternative text when the image cannot be loaded.

    Image

    Select an Image item and click the Edit Names button in the Design Ribbon tab to edit alt text:

    WinForms Dashboard - Edit names from Ribbon

    You can also right-click the item and select Edit Names in the pop-up menu:

    WinForms Dashboard - Edit names from context menu

    Specify alt text in the Edit Names dialog:

    WinForms Dashboard - Set alt text for image

    Click OK to save alt text in the dashboard XML definition.

    In code, use the ImageDashboardItem.ImageAltText property to specify alt text.

    Bound Image

    The Bound Image dashboard item contains the Alternative text data section with the corresponding placeholder. Add a data source field to supply data:

    WinForms Dashboard - Set alt text for Bound Image

    Create a calculated field and use it as an alt text source if you want to share more details with a screen reader.

    To supply alt text for a Bound Image in code, use the BoundImageDashboardItem.ImageAltTextDimension property. Specify a dimension that contains required strings.