ThumbButtonInfo 類別

參考

定義

命名空間:: System.Windows.Shell

組件:: PresentationFramework.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

表示在 Windows 7 工作列縮圖中顯示按鈕之方式的相關資訊。

public ref class ThumbButtonInfo sealed : System::Windows::Freezable, System::Windows::Input::ICommandSource

public sealed class ThumbButtonInfo : System.Windows.Freezable, System.Windows.Input.ICommandSource

type ThumbButtonInfo = class
    inherit Freezable
    interface ICommandSource

Public NotInheritable Class ThumbButtonInfo
Inherits Freezable
Implements ICommandSource

繼承: Object

DispatcherObject

DependencyObject

Freezable
ThumbButtonInfo

實作: ICommandSource

範例

下列範例示範如何在標記中建立 ThumbButtonInfo 。 TaskbarItemInfo包含的集合ThumbButtonInfo從工作列項目提供存取權的婧矔菛 Stop 命令的物件。這個範例是提供給類別之較大範例的 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>

備註

Windows 7 工作列提供增強的功能，可讓您使用工作列按鈕向使用者傳達狀態，並在視窗最小化或隱藏時公開一般工作。您可以將按鈕新增至工作列縮圖，以提供一般工作的存取權，而不需要切換至應用程式視窗。例如，Windows 媒體播放機提供 [播放]、[暫停]、[轉寄] 和 [上一頁] 按鈕，您可以在應用程式最小化時，用來控制工作列縮圖中的媒體播放。

類別 ThumbButtonInfo 包含屬性，描述 Windows 7 殼層如何在工作列縮圖中顯示按鈕。它會提供原生 Windows API 的 Managed 包裝函式。 ThumbButtonInfo 物件包含在集合中 TaskbarItemInfo.ThumbButtonInfos 。

增強的工作列功能不適用於 Windows 7 之前的 Windows 版本。在 Windows 7 中，根據使用者的設定，可能無法使用某些功能。例如，只有在啟用 Windows 裝置時，工作列縮圖才會顯示按鈕。您的應用程式應該提供與不相依于增強工作列功能之使用者互動的替代方式。

下圖顯示了帶有兩個拇指按鈕的任務欄預覽，這兩個拇指按鈕可用於訪問“播放”和“停止”命令。

工作列專案資訊範例任務
Windows 工作列指紋按鈕

建構函式

ThumbButtonInfo()

初始化 ThumbButtonInfo 類別的新執行個體。

欄位

CommandParameterProperty	識別 CommandParameter 相依性屬性。
CommandProperty	識別 Command 相依性屬性。
CommandTargetProperty	識別 CommandTarget 相依性屬性。
DescriptionProperty	識別 Description 相依性屬性。
DismissWhenClickedProperty	識別 DismissWhenClicked 相依性屬性。
ImageSourceProperty	識別 ImageSource 相依性屬性。
IsBackgroundVisibleProperty	識別 IsBackgroundVisible 相依性屬性。
IsEnabledProperty	識別 IsEnabled 相依性屬性。
IsInteractiveProperty	識別 IsInteractive 相依性屬性。
VisibilityProperty	識別 Visibility 相依性屬性。

屬性

CanFreeze	取得值，指出是否可以將物件設為不可修改。 (繼承來源 Freezable)
Command	取得或設定按一下這個縮圖按鈕時要叫用的命令。
CommandParameter	取得或設定要傳遞至 Command 屬性的參數。
CommandTarget	取得或設定引發指定命令的元素。
DependencyObjectType	DependencyObjectType取得包裝這個實例之 CLR 型別的。 (繼承來源 DependencyObject)
Description	取得或設定縮圖按鈕工具提示要顯示的文字。
DismissWhenClicked	取得或設定值，這個值表示是否在按一下縮圖按鈕時關閉工作列縮圖。
Dispatcher	取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject)
ImageSource	取得或設定顯示在縮圖按鈕上的影像。
IsBackgroundVisible	取得或設定值，這個值表示是否在縮圖按鈕周圍顯示框線及反白。
IsEnabled	取得或設定值，這個值表示縮圖按鈕是否已啟用。
IsFrozen	取得值，該值表示物件目前是否可修改。 (繼承來源 Freezable)
IsInteractive	取得或設定值，這個值表示使用者是否可以和縮圖按鈕互動。
IsSealed	取得值，這個值表示此執行個體目前是否已密封 (唯讀)。 (繼承來源 DependencyObject)
Visibility	取得或設定值，這個值指定縮圖按鈕的顯示狀態。

方法

CheckAccess()	判斷呼叫的執行是否可以存取這個 DispatcherObject。 (繼承來源 DispatcherObject)
ClearValue(DependencyProperty)	清除屬性的區域數值。要清除的屬性是由 DependencyProperty 識別項所指定。 (繼承來源 DependencyObject)
ClearValue(DependencyPropertyKey)	清除唯讀屬性的區域數值。要清除的屬性是由 DependencyPropertyKey 所指定。 (繼承來源 DependencyObject)
Clone()	建立這個 Freezable 的可修改複製，製作這個物件值的深層複製。當複製這個物件的相依性屬性時，這個方法會複製運算式 (但可能已不再解析)，但不會複製動畫或其目前值。 (繼承來源 Freezable)
CloneCore(Freezable)	使用基底 (非動畫) 屬性值，將執行個體設為指定 Freezable 的複製品 (深層複製)。 (繼承來源 Freezable)
CloneCurrentValue()	使用 Freezable 的目前值，建立它的可修改複製品 (深層複本)。 (繼承來源 Freezable)
CloneCurrentValueCore(Freezable)	使用目前的屬性值，讓執行個體成為指定之 Freezable 的可修改複本 (深層複本)。 (繼承來源 Freezable)
CoerceValue(DependencyProperty)	強制轉型所指定相依性屬性的值。完成方式是叫用存在於呼叫 DependencyObject 之相依性屬性的屬性中繼資料中所指定的任何 CoerceValueCallback 函式。 (繼承來源 DependencyObject)
CreateInstance()	初始化 Freezable 類別的新執行個體。 (繼承來源 Freezable)
CreateInstanceCore()	在衍生類別中實作時，建立 Freezable 衍生類別的新執行個體。 (繼承來源 Freezable)
Equals(Object)	判斷提供的 DependencyObject 和目前的 DependencyObject 是否相等。 (繼承來源 DependencyObject)
Freeze()	將目前的物件設為不可修改，並將其 IsFrozen 屬性設定為 `true`。 (繼承來源 Freezable)
FreezeCore(Boolean)	將 Freezable 物件設為不可修改的，或測試是否可以將它設為不可修改的。 (繼承來源 Freezable)
GetAsFrozen()	使用基底 (非動畫) 屬性值，建立 Freezable 的凍結複本。因為複本已凍結，所以會以傳址方式複製任何凍結子物件。 (繼承來源 Freezable)
GetAsFrozenCore(Freezable)	使用基底 (非動畫) 屬性值，將執行個體設為指定 Freezable 的凍結複本。 (繼承來源 Freezable)
GetCurrentValueAsFrozen()	使用目前屬性值，建立 Freezable 的凍結複本。因為複本已凍結，所以會以傳址方式複製任何凍結子物件。 (繼承來源 Freezable)
GetCurrentValueAsFrozenCore(Freezable)	將目前執行個體設為所指定 Freezable 的凍結複本。如果物件具有動畫相依性屬性，則會複製其目前的動畫值。 (繼承來源 Freezable)
GetHashCode()	取得這個 DependencyObject 的雜湊碼。 (繼承來源 DependencyObject)
GetLocalValueEnumerator()	建立特定的列舉值，以判斷哪些相依性屬性在此 DependencyObject 上具有本機設定的值。 (繼承來源 DependencyObject)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetValue(DependencyProperty)	傳回 DependencyObject 的這個執行個體上之相依性屬性的目前有效值。 (繼承來源 DependencyObject)
InvalidateProperty(DependencyProperty)	重新評估指定相依性屬性的有效值。 (繼承來源 DependencyObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnChanged()	目前的 Freezable 物件遭到修改時進行呼叫。 (繼承來源 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	確定已為剛剛設定的 DependencyObjectType 資料成員，建立適當的內容指標。 (繼承來源 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	此成員支援Windows Presentation Foundation (WPF) 基礎結構，而且不適合直接從程式碼使用。 (繼承來源 Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	覆寫 OnPropertyChanged(DependencyPropertyChangedEventArgs) 的 DependencyObject 實作也可以叫用任何 Changed 處理常式，以回應類型 Freezable 的變更相依性屬性。 (繼承來源 Freezable)
ReadLocalValue(DependencyProperty)	傳回相依性屬性的區域值 (如果存在)。 (繼承來源 DependencyObject)
ReadPreamble()	確定 Freezable 是從有效的執行緒進行存取。如果 API 會讀取非相依性屬性的資料成員，則 Freezable 的繼承者必須在該 API 的開頭呼叫這個方法。 (繼承來源 Freezable)
SetCurrentValue(DependencyProperty, Object)	設定相依性屬性的值，而不需要變更其值來源。 (繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)	設定相依性屬性的區域值 (由相依性屬性的識別碼所指定)。 (繼承來源 DependencyObject)
SetValue(DependencyPropertyKey, Object)	設定唯讀相依性屬性的區域數值 (由相依性屬性的 DependencyPropertyKey 識別項所指定)。 (繼承來源 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	傳回值，這個值表示序列化程序是否應該序列化所提供相依性屬性的值。 (繼承來源 DependencyObject)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
VerifyAccess()	請強制執行可以存取這個 DispatcherObject 的呼叫執行緒。 (繼承來源 DispatcherObject)
WritePostscript()	引發 Freezable 的 Changed 事件，並叫用其 OnChanged() 方法。在任何 API 修改未以相依性屬性儲存的類別成員之後，衍生自 Freezable 的類別應該在 API 的結尾呼叫這個方法。 (繼承來源 Freezable)
WritePreamble()	確認 Freezable 未凍結，而且是從有效的執行緒內容進行存取。在任何 API 將資料寫入至非相依性屬性的資料成員之前，Freezable 繼承者應該在 API 的開頭呼叫這個方法。 (繼承來源 Freezable)

事件

Changed	發生於 Freezable 或所含的物件遭到修改時。 (繼承來源 Freezable)
Click	發生於按一下縮圖按鈕時。

適用於

另請參閱

TaskbarItemInfo

ThumbButtonInfo 類別

定義

範例

備註

建構函式

欄位

屬性

方法

事件

適用於

另請參閱

意見反應

其他資源