Поделиться через


ImageIcon Класс

Определение

Представляет значок, который использует изображение в качестве содержимого.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ImageIcon : IconElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ImageIcon : IconElement
Public Class ImageIcon
Inherits IconElement
Наследование
ImageIcon
Атрибуты

Примеры

Совет

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе Значки для приложений для Windows.

Приложения из коллекции WinUI 3 и коллекции WinUI 2 включают интерактивные примеры большинства элементов управления, возможностей и функций WinUI 3 и WinUI 2.

Если они уже установлены, откройте их с помощью следующих ссылок: коллекция WinUI 3 или коллекция WinUI 2.

Если они не установлены, вы можете скачать коллекцию WinUI 3 и коллекцию WinUI 2 из Microsoft Store.

Исходный код можно также получить из GitHub (используйте главную ветвь для WinUI 3 и ветвь winui2 для WinUI 2).

В следующем примере показан элемент AppBarButton с .ImageIcon Source указывает изображение, входящее в пакет приложения.

<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->

<AppBarButton Label="ImageIcon">
    <AppBarButton.Icon>
        <muxc:ImageIcon Source="ms-appx:///Assets/globe.png"/>
    </AppBarButton.Icon>
</AppBarButton>

Здесь мы покажем, как загрузить ImageIcon из потока точечных изображений.

// using muxc = Microsoft.UI.Xaml.Controls;

var bitmapSource = new BitmapSource();
await bitmapSource.SetSourceAsync(bitmapStream);
var icon = new muxc.ImageIcon() { Source = bitmapSource };

Комментарии

Поддерживаемые типы образов: .bmp, .gif, .jpg, .png, .wdp и .tiff.

Изображение должно быть сплошным на прозрачном фоне.

Используется только первый кадр многокадрового изображения. Сведения об использовании анимированных значков см. в разделе AnimatedIcon.

Из-за поддерживаемых ImageIcon типов файлов игнорирует свойство Foreground , поэтому вы не можете изменить цвет переднего плана, как в других производных элементах управления IconSource .

ImageIcon обычно используется с элементом AppBarButton, но его можно использовать везде IconElement , где можно использовать .

Конструкторы

ImageIcon()

Инициализирует новый экземпляр класса ImageIcon.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Свойства

Source

Возвращает или задает универсальный код ресурса (URI) файла изображения, используемого в качестве значка.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

SourceProperty

Идентифицирует свойство зависимостей Source.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Применяется к

См. также раздел