BitmapIcon BitmapIcon BitmapIcon Class


Represents an icon that uses a bitmap as its content.

public class BitmapIcon : IconElement, IBitmapIcon, IBitmapIcon2public class BitmapIcon : IconElement, IBitmapIcon, IBitmapIcon2Public Class BitmapIcon Inherits IconElement Implements IBitmapIcon, IBitmapIcon2
<BitmapIcon .../>
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Inherited Members

Inherited properties

Inherited events

Inherited methods


To use a BitmapIcon as the Icon for an AppBarButton, you specify the URI of an image file.

The file that you use should be a solid image on a transparent background. The bitmap image as retrieved from the UriSource location is expected to be a true bitmap that has transparent pixels and non-transparent pixels. The recommended format is PNG. Other file-format image sources will load apparently without error but result in a solid block of the foreground color inside the AppBarButton.

All color info is stripped from the bitmap when the BitmapIcon renders in an AppBarButton. The remaining non-transparent colors are combined to produce an image that's entirely the foreground color as set by the Foreground property (this typically comes from styles or templates, such as the default template resolving to a theme resource).

You typically specify a UriSource value that references a bitmap that you've included as part of the app, as a resource or otherwise within the app package. For more info on the ms-appx: scheme and other URI schemes that you can use to reference resources in your app, see Uri schemes.


You can set the Foreground property on the AppBarButton or on the BitmapIcon. If you set the Foreground on the AppBarButton, it's applied only to the default visual state. It's not applied to the other visual states defined in the AppBarButton template, like MouseOver. If you set the Foreground on the BitmapIcon, the color is applied to all visual states.


This example shows an AppBarButton with a BitmapIcon. The UriSource specifies an image that's included in the app package.

<AppBarButton Label="BitmapIcon" Click="AppBarButton_Click">
        <BitmapIcon UriSource="ms-appx:///Assets/globe.png"/>


BitmapIcon() BitmapIcon() BitmapIcon()

Initializes a new instance of the BitmapIcon class.

public BitmapIcon()public BitmapIcon()Public Sub New()


ShowAsMonochrome ShowAsMonochrome ShowAsMonochrome

Gets or sets a value that indicates whether the bitmap is shown in a single color.

public bool ShowAsMonochrome { get; set; }public bool ShowAsMonochrome { get; set; }Public ReadWrite Property ShowAsMonochrome As bool
bool bool bool

true to show the bitmap in a single color; false to show the bitmap in full color. The default is true.


ShowAsMonochromeProperty ShowAsMonochromeProperty ShowAsMonochromeProperty

Identifies the ShowAsMonochrome dependency property.

public static DependencyProperty ShowAsMonochromeProperty { get; }public static DependencyProperty ShowAsMonochromeProperty { get; }Public Static ReadOnly Property ShowAsMonochromeProperty As DependencyProperty
DependencyProperty DependencyProperty DependencyProperty

The identifier for the ShowAsMonochrome dependency property.


UriSource UriSource UriSource

Gets or sets the Uniform Resource Identifier (URI) of the bitmap to use as the icon content.

public Uri UriSource { get; set; }public Uri UriSource { get; set; }Public ReadWrite Property UriSource As Uri
<BitmapIcon UriSource="uriString"/>
Uri Uri Uri

The Uri of the bitmap to use as the icon content. The default is null.

See Also

UriSourceProperty UriSourceProperty UriSourceProperty

Identifies the UriSource dependency property.

public static DependencyProperty UriSourceProperty { get; }public static DependencyProperty UriSourceProperty { get; }Public Static ReadOnly Property UriSourceProperty As DependencyProperty
DependencyProperty DependencyProperty DependencyProperty

The identifier for the UriSource dependency property.


See Also