NONCLIENTMETRICSW 構造体 (winuser.h)

ミニマイズされていないウィンドウの非クライアント領域に関連付けられたスケーラブルなメトリックが含まれます。 この構造体は、SystemParametersInfo 関数の SPI_GETNONCLIENTMETRICS および SPI_SETNONCLIENTMETRICS アクションによって使用されます。

構文

typedef struct tagNONCLIENTMETRICSW {
  UINT     cbSize;
  int      iBorderWidth;
  int      iScrollWidth;
  int      iScrollHeight;
  int      iCaptionWidth;
  int      iCaptionHeight;
  LOGFONTW lfCaptionFont;
  int      iSmCaptionWidth;
  int      iSmCaptionHeight;
  LOGFONTW lfSmCaptionFont;
  int      iMenuWidth;
  int      iMenuHeight;
  LOGFONTW lfMenuFont;
  LOGFONTW lfStatusFont;
  LOGFONTW lfMessageFont;
  int      iPaddedBorderWidth;
} NONCLIENTMETRICSW, *PNONCLIENTMETRICSW, *LPNONCLIENTMETRICSW;

メンバーズ

cbSize

構造体のサイズ (バイト単位)。 呼び出し元は、これを sizeof(NONCLIENTMETRICS)に設定する必要があります。 アプリケーションの互換性については、「解説」を参照してください。

iBorderWidth

サイズ変更の境界線の太さ (ピクセル単位)。 既定値は 1 ピクセルです。

iScrollWidth

標準の垂直スクロール バーの幅 (ピクセル単位)。

iScrollHeight

標準の水平スクロール バーの高さ (ピクセル単位)。

iCaptionWidth

キャプション ボタンの幅 (ピクセル単位)。

iCaptionHeight

キャプション ボタンの高さ (ピクセル単位)。

lfCaptionFont

キャプション フォントに関する情報を含む LOGFONT 構造体。

iSmCaptionWidth

小さいキャプション ボタンの幅 (ピクセル単位)。

iSmCaptionHeight

小さいキャプションの高さ (ピクセル単位)。

lfSmCaptionFont

小さいキャプション フォントに関する情報を含む LOGFONT 構造体。

iMenuWidth

メニュー バー ボタンの幅 (ピクセル単位)。

iMenuHeight

メニュー バーの高さ (ピクセル単位)。

lfMenuFont

メニュー バーで使用されるフォントに関する情報を含む LOGFONT 構造体。

lfStatusFont

ステータス バーとツールヒントで使用されるフォントに関する情報を含む LOGFONT 構造体。

lfMessageFont

メッセージ ボックスで使用されるフォントに関する情報を格納する LOGFONT 構造体。

iPaddedBorderWidth

埋め込まれた境界線の太さ (ピクセル単位)。 既定値は 4 ピクセルです。 iPaddedBorderWidth と iBorderWidth メンバーは、Windows Aero デスクトップ エクスペリエンスでサイズ変更可能なウィンドウと表示できないウィンドウの両方に結合されます。 このメンバーを使用するアプリケーションをコンパイルするには、_WIN32_WINNT を 0x0600 以降として定義します。 詳細については、「解説」を参照してください。

Windows Server 2003 および Windows XP/2000: このメンバーはサポートされていません。

備考

NONCLIENTMETRICS 構造体の iPaddedBorderWidth メンバーが存在する場合、この構造体は、0x0502以下の _WIN32_WINNT でコンパイルされるアプリケーションの場合より 4 バイト大きくなります。 条件付きコンパイルの詳細については、「Windows ヘッダーの使用」を参照してください。

Windows Server 2003 および Windows XP/2000: Windows Server 2008 または Windows Vista 用にコンパイルされたアプリケーションも Windows Server 2003 または Windows XP/2000 で実行する必要がある場合、 GetVersionEx 関数を使用して、実行時にオペレーティング システムのバージョンを確認し、アプリケーションが Windows Server 2003 または Windows XP/2000 で実行されている場合は、 SystemParametersInfo 関数を呼び出す前に、nonCLIENTMETRICS 構造体の cbSize メンバーから、iPaddedBorderWidth メンバーのサイズを減算します。

手記

winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして NONCLIENTMETRICS を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	winuser.h (Windows.h を含む)

関連項目

LOGFONT の

SystemParametersInfo