ThumbButtonInfo 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 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
- 繼承
- 實作
範例
以下範例說明如何建立 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 |
|---|---|
| Changed |
當 Freezable 它所包含的物件被修改時,會發生這種情況。 (繼承來源 Freezable) |
| Click |
點擊縮圖按鈕時會發生。 |