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 in 標記並設定屬性 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