VisualStyleRenderer.Handle プロパティ

.NET Framework クラス ライブラリ リファレンス

VisualStyleRenderer.Handle プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

visual スタイル要素の現在のクラスの一意の識別子を取得します。

名前空間: System.Windows.Forms.VisualStyles
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Handle As IntPtr

Visual Basic (使用法)

Dim instance As VisualStyleRenderer
Dim value As IntPtr

value = instance.Handle

C#

public IntPtr Handle { get; }

C++

public:
property IntPtr Handle {
    IntPtr get ();
}

J#

/** @property */
public IntPtr get_Handle ()

JScript

public function get Handle
 () : IntPtr

プロパティ値
Class によって指定される要素のクラスを定義しているデータ セットを識別する IntPtr。

例外

例外の種類	条件
InvalidOperationException	オペレーティング システムが visual スタイルをサポートしていません。 または visual スタイルがオペレーティング システムでユーザーにより無効にされています。 または visual スタイルがアプリケーション ウィンドウのクライアント領域に適用されていません。

解説

このプロパティは、VisualStyleRenderer メソッドが内部で使用します。Class プロパティによって指定される要素のクラスを、現在の visual スタイルが定義していない場合、このプロパティは IntPtr.Zero を返します。

オペレーティング システムの visual スタイルが変更された場合、またはユーザーが visual スタイルを無効にした場合、このプロパティ値は無効になります。このプロパティに直接アクセスする場合は、UserPreferenceCategory.VisualStyle の UserPreferenceChangedEventArgs.Category プロパティ値を使用する SystemEvents.UserPreferenceChanged イベントが発生した時点で、コードからこのプロパティに再度問い合わせを行い、新しいハンドラを取得する必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
VisualStyleRenderer クラス
VisualStyleRenderer メンバ
System.Windows.Forms.VisualStyles 名前空間