ThumbButtonInfo クラス

Windows 7 タスク バーのサムネイルにボタンを表示する方法に関する情報を表します。

継承階層

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        Microsoft.Windows.Shell.ThumbButtonInfo

名前空間:  Microsoft.Windows.Shell
アセンブリ:  Microsoft.Windows.Shell (Microsoft.Windows.Shell.dll 内)

構文

'宣言
Public NotInheritable Class ThumbButtonInfo _
    Inherits Freezable _
    Implements ICommandSource

public sealed class ThumbButtonInfo : Freezable, 
    ICommandSource

public ref class ThumbButtonInfo sealed : public Freezable, 
    ICommandSource

[<Sealed>]
type ThumbButtonInfo =  
    class
        inherit Freezable
        interface ICommandSource
    end

public final class ThumbButtonInfo extends Freezable implements ICommandSource

ThumbButtonInfo 型で公開されるメンバーは以下のとおりです。

コンストラクター

	名前	説明
	ThumbButtonInfo	ThumbButtonInfo クラスの新しいインスタンスを初期化します。

このページのトップへ

プロパティ

	名前	説明
	CanFreeze	オブジェクトを変更不可能な状態にできるかどうかを示す値を取得します。 (Freezable から継承されます。)
	Command	このサムネイル ボタンがクリックされたときに呼び出すコマンドを取得または設定します。
	CommandParameter	Command プロパティに渡すパラメーターを取得または設定します。
	CommandTarget	指定したコマンドが実行される要素を取得または設定します。
	DependencyObjectType	このインスタンスの CLR 型をラップする DependencyObjectType を取得します。  (DependencyObject から継承されます。)
	Description	サムネイル ボタンのツールヒントに表示するテキストを取得または設定します。
	DismissWhenClicked	サムネイル ボタンがクリックされたときにタスク バーのサムネイルを閉じるかどうかを示す値を取得または設定します。
	Dispatcher	この DispatcherObject が関連付けられている Dispatcher を取得します。 (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 から継承されます。)
	CloneCurrentValue	Freezable の現在の値を使用して、変更可能な複製 (詳細コピー) を作成します。 (Freezable から継承されます。)
	CloneCurrentValueCore	プロパティの現在の値を使用して、インスタンスを、指定した Freezable の変更可能な複製 (詳細コピー) にします。 (Freezable から継承されます。)
	CoerceValue	指定した依存関係プロパティの値を強制します。これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティ メタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。 (DependencyObject から継承されます。)
	CreateInstance	Freezable クラスの新しいインスタンスを初期化します。 (Freezable から継承されます。)
	CreateInstanceCore	派生クラスで実装された場合、Freezable 派生クラスの新しいインスタンスを作成します。 (Freezable から継承されます。)
	Equals	指定した DependencyObject が現在の DependencyObject と等しいかどうかを判断します。 (DependencyObject から継承されます。)
	Finalize	オブジェクトがガベージ コレクションにより収集される前に、そのオブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	Freeze	現在のオブジェクトを変更不可能な状態にして、その IsFrozen プロパティを true に設定します。 (Freezable から継承されます。)
	FreezeCore	Freezable オブジェクトを変更不可能な状態にするか、変更不可能な状態にできるかどうかをテストします。 (Freezable から継承されます。)
	GetAsFrozen	基本プロパティ値 (アニメーション化されていない値) を使用して、Freezable の 固定されたコピーを作成します。コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。 (Freezable から継承されます。)
	GetAsFrozenCore	基本プロパティ値 (アニメーション化されていない値) を使用して、インスタンスを、指定した Freezable の固定された複製にします。 (Freezable から継承されます。)
	GetCurrentValueAsFrozen	現在のプロパティ値を使用して、Freezable の固定されたコピーを作成します。コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。 (Freezable から継承されます。)
	GetCurrentValueAsFrozenCore	現在のインスタンスを、指定した Freezable の固定された複製にします。オブジェクトに、アニメーション化された依存関係プロパティが存在する場合、現在アニメーション化されている値がコピーされます。 (Freezable から継承されます。)
	GetHashCode	この DependencyObject のハッシュ コードを取得します。 (DependencyObject から継承されます。)
	GetLocalValueEnumerator	どの依存関係プロパティがこの DependencyObject 上にローカルに設定された値を持つかを確認するための、専用の列挙子を作成します。 (DependencyObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetValue	DependencyObject のこのインスタンスにある依存関係プロパティの現在の有効値を返します。 (DependencyObject から継承されます。)
	InvalidateProperty	指定した依存関係プロパティの有効値を再評価します。 (DependencyObject から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnChanged	現在の Freezable オブジェクトが変更されると呼び出されます。 (Freezable から継承されます。)
	OnFreezablePropertyChanged(DependencyObject, DependencyObject)	設定されたばかりの DependencyObjectType データ メンバーに対して、適切なコンテキスト ポインターが確立されていることを確認します。 (Freezable から継承されます。)
	OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートします。コードから直接使用するためのものではありません。 (Freezable から継承されます。)
	OnPropertyChanged	DependencyObject の OnPropertyChanged 実装をオーバーライドして、Freezable 型の依存関係プロパティの変更に応答して任意の Changed ハンドラーも呼び出されるようにします。 (Freezable から継承されます。)
	ReadLocalValue	依存関係プロパティのローカル値が存在する場合に、そのローカル値を返します。 (DependencyObject から継承されます。)
	ReadPreamble	Freezable が有効なスレッドからアクセスされていることを確認します。Freezable の継承側は、依存関係プロパティでないデータ メンバーを読み取る任意の API の開始時に、このメソッドを呼び出す必要があります。 (Freezable から継承されます。)
	SetValue(DependencyProperty, Object)	依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。 (DependencyObject から継承されます。)
	SetValue(DependencyPropertyKey, Object)	読み取り専用の依存関係プロパティの DependencyPropertyKey 識別子を指定して、該当する依存関係プロパティのローカル値を設定します。 (DependencyObject から継承されます。)
	ShouldSerializeProperty	シリアル化プロセスが、指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (DependencyObject から継承されます。)
	ToString	現在のオブジェクトを表す文字列を返します。 (Object から継承されます。)
	VerifyAccess	呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。 (DispatcherObject から継承されます。)
	WritePostscript	Freezable の Changed イベントを発生させ、その OnChanged メソッドを呼び出します。Freezable から派生するクラスは、依存関係プロパティとして格納されていないクラス メンバーを変更する任意の API の終了時に、このメソッドを呼び出す必要があります。 (Freezable から継承されます。)
	WritePreamble	Freezable が固定されておらず、有効なスレッド コンテキストからアクセスされていることを確認します。Freezable の継承側は、依存関係プロパティでないデータ メンバーに書き込む任意の API の開始時に、このメソッドを呼び出す必要があります。 (Freezable から継承されます。)

このページのトップへ

イベント

	名前	説明
	Changed	Freezable 、またはこれに含まれているオブジェクトが変更されると発生します。 (Freezable から継承されます。)
	Click	サムネイル ボタンがクリックされたときに発生します。

このページのトップへ

フィールド

	名前	説明
	CommandParameterProperty	CommandParameter 依存関係プロパティを識別します。
	CommandProperty	Command 依存関係プロパティを識別します。
	CommandTargetProperty	CommandTarget 依存関係プロパティを識別します。
	DescriptionProperty	Description 依存関係プロパティを識別します。
	DismissWhenClickedProperty	DismissWhenClicked 依存関係プロパティを識別します。
	ImageSourceProperty	ImageSource 依存関係プロパティを識別します。
	IsBackgroundVisibleProperty	IsBackgroundVisible 依存関係プロパティを識別します。
	IsEnabledProperty	IsEnabled 依存関係プロパティを識別します。
	IsInteractiveProperty	IsInteractive 依存関係プロパティを識別します。
	VisibilityProperty	Visibility 依存関係プロパティを識別します。

このページのトップへ

解説

Windows 7 タスクバーは、ステータスをユーザーと通信し、ウィンドウを最小化または非表示にするときの一般的なタスクを公開するために、タスク バー ボタンを使用できるように拡張機能を提供します。 アプリケーション ウィンドウを切り替えることなく一般的なタスクにアクセスできるようにタスク バー サムネイルにボタンを追加できます。 たとえば、Windows Media Player には、アプリケーションを最小化したときに、タスク バーのサムネイルからメディアの再生を制御するのに使用できる [再生]、[一時停止]、[転送] および [戻る] ボタンが用意されています。

ThumbButtonInfo クラスには、Windows 7 シェルがタスク バーのサムネイルでボタンを表示する方法について説明するプロパティが含まれています。 これは、ネイティブ Windows API のマネージ ラッパーを提供します。 ThumbButtonInfo オブジェクトは、TaskbarItemInfo.ThumbButtonInfos コレクションに含まれています。

タスク バーの拡張機能は、Windows 7 より前のバージョンの Windows では使用できません。 Windows 7 では、ユーザーの設定によっては一部の機能を利用できない場合があります。 たとえば、ボタンは Windows Aero を有効にすると、タスク バーのサムネイルでのみ表示されます。 アプリケーションは、タスク バーの拡張機能に依存しないユーザーと対話する代替の方法を提供する必要があります。

次の図に、再生および停止のコマンドへのアクセスを提供する 2 つのつまみボタンを持つタスク バー プレビューを示します。

Windows タスク バーのつまみボタン

スレッド セーフ

この型のすべてのパブリック static (Visual Basic では Shared) メンバーは、スレッド セーフです。 インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

参照

参照

Microsoft.Windows.Shell 名前空間

TaskbarItemInfo