ThumbButtonInfo クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Windows 7 タスク バーのサムネイルにボタンを表示する方法に関する情報を表します。
public ref class ThumbButtonInfo sealed : System::Windows::Freezable, System::Windows::Input::ICommandSourcepublic sealed class ThumbButtonInfo : System.Windows.Freezable, System.Windows.Input.ICommandSourcetype ThumbButtonInfo = class
inherit Freezable
interface ICommandSourcePublic NotInheritable Class ThumbButtonInfo
Inherits Freezable
Implements ICommandSource- 継承
- 実装
例
次の例は、マークアップで を作成する方法を ThumbButtonInfo 示しています。 TaskbarItemInfoには、タスク バー項目から Play コマンドと Stop コマンドへのアクセスを提供するオブジェクトのコレクション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 メディア プレーヤーには[再生]、[一時停止]、[進む]、[戻る] の各ボタンが用意されており、アプリケーションが最小化されたときにタスク バーのサムネイルからメディアの再生を制御できます。
ThumbButtonInfoクラスには、Windows 7 シェルがタスク バーのサムネイルにボタンを表示する方法を説明するプロパティが含まれています。 ネイティブ Windows API のマネージド ラッパーが提供されます。 ThumbButtonInfo オブジェクトはコレクションに TaskbarItemInfo.ThumbButtonInfos 含まれています。
強化されたタスク バー機能は、Windows 7 より前のバージョンの Windows では使用できません。 Windows 7 では、ユーザーの設定によっては一部の機能が使用できない場合があります。 たとえば、ボタンは、Windows Aero が有効になっている場合にのみタスク バーのサムネイルに表示されます。 アプリケーションでは、強化されたタスク バー機能に依存しないユーザーと対話する別の方法を提供する必要があります。
次の図は、タスク バーのプレビューと、Play コマンドと Stop コマンドへのアクセスを提供する 2 つのサム ボタンを示しています。
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 プロパティを |
| 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 実装をオーバーライドして、さらに型 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() |
Freezable の Changed イベントを発生させ、その OnChanged() メソッドを呼び出します。 Freezable から派生するクラスは、依存関係プロパティとして格納されていないクラス メンバーを変更するすべての API の終了時に、このメソッドを呼び出す必要があります。 (継承元 Freezable) |
| WritePreamble() |
Freezable が固定されておらず、有効なスレッド コンテキストからアクセスされていることを確認します。 Freezable の継承側は、依存関係プロパティでないデータ メンバーに書き込む任意の API の開始時に、このメソッドを呼び出す必要があります。 (継承元 Freezable) |
イベント
| Changed |
Freezable、またはこれに含まれているオブジェクトが変更されると発生します。 (継承元 Freezable) |
| Click |
サムネイル ボタンがクリックされたときに発生します。 |
適用対象
こちらもご覧ください
.NET