共用方式為


ThumbButtonInfo 類別

定義

代表如何在 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
繼承
實作

範例

以下範例說明如何建立 ThumbButtonInfo in 標記。 裡面 TaskbarItemInfo 包含一組 ThumbButtonInfo 物件,提供從工作列項目中存取播放和停止指令的權限。 此範例是本類別更大 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 Media Player 提供播放、暫停、快轉和返回按鈕,當應用程式最小化時,你可以從工作列縮圖控制媒體播放。

ThumbButtonInfo 類別包含描述 Windows 7 shell 如何在工作列縮圖中顯示按鈕的屬性。 它提供一個圍繞原生 Windows API 的受管理包裝器。 ThumbButtonInfo 物件包含在集合 TaskbarItemInfo.ThumbButtonInfos 中。

強化工作列功能在 Windows 7 之前的版本中無法使用。 在 Windows 7 中,根據使用者的設定,某些功能可能無法使用。 例如,只有啟用 Windows Aero 時,按鈕才會出現在工作列縮圖中。 你的應用程式應該提供與使用者互動的替代方式,這些方式不依賴增強工作列功能。

以下圖示展示了工作列預覽,並有兩個拇指按鈕,提供播放與停止指令的存取。

工作列項目資訊範例 Windows 工作列拇指按鈕

建構函式

名稱 Description
ThumbButtonInfo()

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

欄位

名稱 Description
CommandParameterProperty

識別 CommandParameter 依賴性質。

CommandProperty

識別 Command 依賴性質。

CommandTargetProperty

識別 CommandTarget 依賴性質。

DescriptionProperty

識別 Description 依賴性質。

DismissWhenClickedProperty

識別 DismissWhenClicked 依賴性質。

ImageSourceProperty

識別 ImageSource 依賴性質。

IsBackgroundVisibleProperty

識別 IsBackgroundVisible 依賴性質。

IsEnabledProperty

識別 IsEnabled 依賴性質。

IsInteractiveProperty

識別 IsInteractive 依賴性質。

VisibilityProperty

識別 Visibility 依賴性質。

屬性

名稱 Description
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

取得或設定一個值,指定縮圖按鈕的顯示狀態。

方法

名稱 Description
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)

強制設定指定的依賴性質值。 這是透過在屬性CoerceValueCallback中指定的依賴屬性元資料中,呼叫 的依賴屬性中的任何DependencyObject函式來達成的。

(繼承來源 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, DependencyProperty)

此成員支援 Windows Presentation Foundation(WPF)基礎架構,並非直接從您的程式碼中使用。

(繼承來源 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

確保剛設定的資料成員建立 DependencyObjectType 適當的上下文指標。

(繼承來源 Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

DependencyObject寫 的OnPropertyChanged(DependencyPropertyChangedEventArgs)實作,也在回應類型中變動的依賴屬性Freezable時呼叫任何Changed處理器。

(繼承來源 Freezable)
ReadLocalValue(DependencyProperty)

回傳依賴屬性的局部值(若存在)。

(繼承來源 DependencyObject)
ReadPreamble()

確保存取 Freezable 的是有效的執行緒。 繼 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()

提升 Changed 事件並 Freezable 調用其 OnChanged() 方法。 衍生於 的 Freezable 類別應在任何修改未儲存為相依屬性的類別成員的 API 結尾呼叫此方法。

(繼承來源 Freezable)
WritePreamble()

驗證 未 Freezable 被凍結,且存取時正從有效的執行緒上下文中存取。 Freezable 繼承者應在任何寫入非相依屬性資料成員的 API 開頭呼叫此方法。

(繼承來源 Freezable)

事件

名稱 Description
Changed

Freezable 它所包含的物件被修改時,會發生這種情況。

(繼承來源 Freezable)
Click

點擊縮圖按鈕時會發生。

適用於

另請參閱