TaskbarItemInfo.Overlay プロパティ

定義

名前空間:

System.Windows.Shell

アセンブリ:

PresentationFramework.dll

タスク バー ボタンのプログラム アイコン上に表示されるイメージを取得または設定します。

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

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

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

Public Property Overlay As ImageSource

プロパティ値

ImageSource

タスク バー ボタンのプログラム アイコン上に表示されるイメージ。 既定値は、null です。

例

次の例は、マークアップで を TaskbarItemInfo 作成し、 プロパティを設定する方法を Overlay 示しています。 この例は、 クラスに対して提供されるより大きな例の TaskbarItemInfo 一部です。

<Window.TaskbarItemInfo>
    <TaskbarItemInfo x:Name="taskBarItemInfo1" 
                     Overlay="{StaticResource ResourceKey=StopImage}"
                     ThumbnailClipMargin="80,0,80,140"
                     Description="Taskbar Item Info Sample">
        <TaskbarItemInfo.ThumbButtonInfos>
            <ThumbButtonInfoCollection>
                <ThumbButtonInfo
                    DismissWhenClicked="False"
                    Command="MediaCommands.Play"
                    CommandTarget="{Binding ElementName=btnPlay}"
                    Description="Play"
                    ImageSource="{StaticResource ResourceKey=PlayImage}"/>
                <ThumbButtonInfo
                    DismissWhenClicked="True"
                    Command="MediaCommands.Stop"
                    CommandTarget="{Binding ElementName=btnStop}"
                    Description="Stop"
                    ImageSource="{StaticResource ResourceKey=StopImage}"/>
            </ThumbButtonInfoCollection>
        </TaskbarItemInfo.ThumbButtonInfos>
    </TaskbarItemInfo>
</Window.TaskbarItemInfo>

次の例は、コードで Overlay プロパティを設定する方法を示しています。

this.taskBarItemInfo1.Overlay = (DrawingImage)this.FindResource("StopImage");

Me.taskBarItemInfo1.Overlay = Me.FindResource("StopImage")

注釈

タスク バー ボタンのプログラム アイコンに画像を追加して、アプリケーションの状態をユーザーに伝えることができます。 オーバーレイは、タスク バー ボタンのアイコンの右下隅に配置された静的またはアニメーションを ImageSource 使用します。 ユーザーがタスク バーに小さなアイコンを表示するように設定した場合、オーバーレイは表示されません。

タスク バーの右端にある通知領域のプログラム アイコンは、通常、アプリケーションの状態をユーザーに伝えるために使用されます。 Windows 7 では、通知領域のプログラム アイコンは既定で非表示になっているため、状態を伝える場合にはあまり役に立ちません。 Windows 7 のタスク バー ボタン オーバーレイを使用すると、通知領域のアイコンが非表示のときに状態を伝えることができます。 アプリケーションは Windows のバージョンを検出し、オペレーティング システムに適した方法で通知を提供できます。

オーバーレイ イメージは適切なサイズでレンダリングされます。 が ImageSource を Icon表す場合は、適切なビット深度も使用されます。

次の図は、タスク バー Overlayを示しています。

Windows タスク バー オーバーレイ

こちらもご覧ください

• Version
• OSVersion