VisualStyleRenderer.Handle プロパティ

定義

名前空間:

System.Windows.Forms.VisualStyles

アセンブリ:

System.Windows.Forms.dll

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

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

public IntPtr Handle { get; }

member this.Handle : nativeint

Public ReadOnly Property Handle As IntPtr

プロパティ値

IntPtr

nativeint

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

例外

InvalidOperationException

オペレーティング システムが visual スタイルをサポートしていません。

または

visual スタイルは、オペレーティング システムのユーザーにより無効にされています。

または

visual スタイルは、アプリケーション ウィンドウのクライアント領域には適用されません。

注釈

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

このプロパティ値は、オペレーティング システムの表示スタイルが変更されたとき、またはユーザーが表示スタイルを無効にした場合に無効になります。 このプロパティに直接アクセスする場合は、プロパティ値 UserPreferenceCategory.VisualStyleが のイベントが発生したときにSystemEvents.UserPreferenceChanged、コードでこのプロパティに再度クエリを実行して新しいハンドルを取得するUserPreferenceChangedEventArgs.Category必要があります。