Window.Icon プロパティ

public:
 property System::Windows::Media::ImageSource ^ Icon { System::Windows::Media::ImageSource ^ get(); void set(System::Windows::Media::ImageSource ^ value); };

public System.Windows.Media.ImageSource Icon { get; [System.Security.SecurityCritical] set; }

public System.Windows.Media.ImageSource Icon { get; set; }

[<set: System.Security.SecurityCritical>]
member this.Icon : System.Windows.Media.ImageSource with get, set

member this.Icon : System.Windows.Media.ImageSource with get, set

Public Property Icon As ImageSource

プロパティ値

アイコンを表す ImageSource オブジェクト。

属性

SecurityCriticalAttribute

例

次の例は、ウィンドウ アイコンを設定する方法を示しています。

<Window
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.MainWindow"
    Icon="WPFIcon1.ico">
</Window>

// Set an icon using code
Uri iconUri = new Uri("pack://application:,,,/WPFIcon2.ico", UriKind.RelativeOrAbsolute);
this.Icon = BitmapFrame.Create(iconUri);

' Set an icon using code
Dim iconUri As New Uri("pack://application:,,,/WPFIcon2.ico", UriKind.RelativeOrAbsolute)
Me.Icon = BitmapFrame.Create(iconUri)

注釈

Windows Presentation Foundation (WPF) スタンドアロン アプリケーションには、次の 2 種類のアイコンがあります。

• 1 つのアセンブリ アイコン。アプリケーションのプロジェクト ビルド ファイルで <ApplicationIcon> プロパティを使用して指定されます。 このアイコンは、アセンブリのデスクトップ アイコンとして使用されます。

  Note

  Visual Studio でデバッグする場合、ホスティング プロセスが原因でアイコンが表示されないことがあります。 実行可能ファイルを実行すると、アイコンが表示されます。

• Iconを設定して指定するウィンドウごとに 1 つのアイコン。 各ウィンドウで、このアイコンはタイトル バー、タスク バー ボタン、および ALT-TAB アプリケーション選択リスト エントリで使用されます。

WPF ウィンドウには常にアイコンが表示されます。 Icon設定によって指定されていない場合、WPF は次の規則に基づいて表示するアイコンを選択します。

1. 指定されている場合は、アセンブリ アイコンを使用します。
2. アセンブリ アイコンが指定されていない場合は、既定の Microsoft Windows アイコンを使用します。

Iconを使用してカスタム ウィンドウ アイコンを指定する場合は、Iconを null に設定することで、既定のアプリケーション アイコンを復元できます。

1 つのアイコンは、ウィンドウのタイトル バー、ウィンドウのタスク バー、Alt + TAB ファイル選択リストに表示されるなど、Windows のさまざまな方法で使用できます。 これらのそれぞれは、異なるサイズを使用してアイコンを示しています。ウィンドウのタイトル バーとタスク バーには 16 x 16 ピクセル のアイコンが表示され、Alt + TAB ファイルの選択リストには 32 x 32 ピクセル のアイコンが表示されます。 Microsoft Windows エクスプローラーなどの一部のアプリケーションでは、[ 表示 ] メニューを使用して、表示するアイコンのサイズを選択できます。

さまざまな表示サイズに対応するために、アイコン ファイルは 1 つ以上の実際のアイコンで構成されます。各アイコンは、特定のサイズと色深度を対象とするアイコンのバージョンを表します。 たとえば、1 つのアイコンには 16 色の 16 x 16 ピクセル のアイコンのみが含まれる場合と、16 色と 256 色の両方の 16 x 16 ピクセルと 32 x 32 ピクセルのアイコンを含めることができます。

可能なすべてのサイズと色深度のアイコンがアイコン ファイル内に存在する場合、 Window は適切なアイコンを使用します。 アイコン ファイルに使用可能なすべてのアイコンのサブセットのみが含まれている場合、 Window は、サイズと色の深度を小さくするために、次に最適なアイコンを使用します。

その結果、アイコンは常に Windowによって使用されますが、使用されるアイコンは必要なサイズと色深度を対象としていない可能性があります。 たとえば、16 色の 16 x 16 ピクセル アイコンは、256 色の 32 x 32 ピクセル アイコンとして表示するために使用できます。 これにより、pixilation などの望ましくない視覚効果が発生する可能性がありますが、すべてのターゲット サイズと色深度のアイコンを作成することで回避できます。

依存関係プロパティ情報