ImageIcon クラス

  • リファレンス

定義

名前空間:
Microsoft.UI.Xaml.Controls
編集

Image をコンテンツとして使用するアイコンを表します。

このドキュメントは、UWP 用の WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ 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
継承
IconElement
ImageIcon
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

例

ヒント

詳細、設計ガイダンス、およびコード例については、「 Windows アプリのアイコン」を参照してください。

WinUI 3 ギャラリー アプリと WinUI 2 ギャラリー アプリには、ほとんどの WinUI 3 および WinUI 2 コントロールと機能の対話型の例が含まれています。

既にインストールされている場合は、WinUI 3 ギャラリーまたは WinUI 2 ギャラリーのリンクをクリックして開きます。

インストールされていない場合は、Microsoft Store から WinUI 3 ギャラリーと WinUI 2 ギャラリーをダウンロードできます。

GitHub から両方のソース コードを取得することもできます (WinUI 3 の場合は main ブランチ、WinUI 2 の場合は winui2 ブランチを使用します)。

次の例は、 を含む 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 クラスの新しいインスタンスを初期化します。

このドキュメントは、UWP 用の WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

プロパティ

Source

アイコンとして使用するイメージ ファイルの URI を取得または設定します。

このドキュメントは、UWP 用の WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SourceProperty

Source 依存関係プロパティを識別します。

このドキュメントは、UWP 用の WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

適用対象

こちらもご覧ください