GetThemeMetric 関数 (uxtheme.h)

  • [アーティクル]

メトリック プロパティの値を取得します。

構文

HRESULT GetThemeMetric(
  [in]  HTHEME hTheme,
  [in]  HDC    hdc,
  [in]  int    iPartId,
  [in]  int    iStateId,
  [in]  int    iPropId,
  [out] int    *piVal
);

パラメーター

[in] hTheme

種類: HTHEME

ウィンドウの指定されたテーマ データを処理します。 OpenThemeData を使用して HTHEME を作成します。

[in] hdc

種類: HDC

Hdc。 このパラメーターは NULL に設定できます。

[in] iPartId

型: int

メトリック プロパティを含む部分を指定する int 型の値。 「パーツと状態」を参照してください。

[in] iStateId

型: int

パーツの状態を指定する int 型の値。 「パーツと状態」を参照してください。

[in] iPropId

型: int

取得するプロパティを指定する int 型の値。 次のいずれかの値を指定できます。

値 意味
TMT_ALPHALEVEL
 DrawThemeIcon に使用されるアルファ値 (0 から 255)。
TMT_ALPHATHRESHOLD
 ピクセルを不透明と見なす必要がある最小アルファ値 (0 から 255)。
TMT_BORDERSIZE
 このパーツで罫線の塗りつぶしが使用されている場合に描画される罫線の太さ。
TMT_GLYPHINDEX
 パーツでフォントベースのグリフが使用されている場合にグリフに使用される、選択したフォントの文字インデックス。
TMT_GRADIENTRATIO1
 パーツの描画に使用する最初のグラデーションの色の量。 この値は 0 から 255 までですが、この値に各 GRADIENTRATIO 値を加えた値は、最大 255 まで加算する必要があります。 GetThemeColor のTMT_GRADIENTCOLOR1値を確認します。
TMT_GRADIENTRATIO2
 パーツの描画に使用する 2 番目のグラデーションの色の量。
TMT_GRADIENTRATIO3
 パーツの描画に使用する 3 番目のグラデーションの色の量。
TMT_GRADIENTRATIO4
 パーツの描画に使用する 4 番目のグラデーションの色の量。
TMT_GRADIENTRATIO5
 パーツの描画に使用する 5 番目のグラデーションの色の量。
TMT_HEIGHT
 パーツの高さ。
TMT_IMAGECOUNT
 イメージ ファイルに存在する状態イメージの数。
TMT_MINDPI1
 最初のイメージ ファイルが設計された最小 dpi。 「GetThemeFilename」を参照してください。
TMT_MINDPI2
 2 番目のイメージ ファイルが設計された最小 dpi。
TMT_MINDPI3
 3 番目のイメージ ファイルが設計された最小 dpi。
TMT_MINDPI4
 4 番目のイメージ ファイルが設計された最小 dpi。
TMT_MINDPI5
 5 番目のイメージ ファイルが設計された最小 dpi。
TMT_PROGRESSCHUNKSIZE
 進行状況コントロールの "チャンク" 図形のサイズ。操作の進行状況を定義します。
TMT_PROGRESSSPACESIZE
 すべての進行状況コントロールの "チャンク" の合計サイズ。
TMT_ROUNDCORNERWIDTH
 パーツの角の丸み (0 から 100%)。
TMT_ROUNDCORNERHEIGHT
 パーツの角の丸み (0 から 100%)。
TMT_SATURATION
 DrawThemeIcon を使用して描画されたアイコンに適用する彩度 (0 から 255)。
TMT_TEXTBORDERSIZE
 テキスト文字の周囲に描画される罫線の太さ。
TMT_TRUESIZESTRETCHMARK
 True サイズのイメージの元のサイズに対する、イメージのストレッチの割合。
TMT_WIDTH
 パーツの幅。

[out] piVal

型: int*

メトリック プロパティ値を受け取る int へのポインター。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー uxtheme.h
Library UxTheme.lib
[DLL] UxTheme.dll

こちらもご覧ください

プロパティ識別子