Window.Icon プロパティ

  • リファレンス

定義

名前空間:
System.Windows
アセンブリ:
PresentationFramework.dll

ウィンドウのアイコンを取得または設定します。

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

アイコンを表す 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> プロジェクト ビルド ファイル内のプロパティを使用して指定されます。 このアイコンは、アセンブリのデスクトップ アイコンとして使用されます。

    注意

    Visual Studioでデバッグするとき、ホスティング プロセスのためにアイコンが表示されない場合があります。 実行可能ファイルを実行すると、アイコンが表示されます。 詳細については、「ホスト プロセス (vshost.exe)」を参照してください。

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

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

  1. 指定されている場合は、アセンブリ アイコンを使用します。

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

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

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

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

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

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

注意

ブラウザーでウィンドウがホストされている場合、このプロパティを設定または取得することはできません。

依存プロパティ情報
識別子フィールド IconProperty
に設定されたメタデータ プロパティ true なし

適用対象