NONCLIENTMETRICSA 構造体 (winuser.h)

  • [アーティクル]

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

構文

typedef struct tagNONCLIENTMETRICSA {
  UINT     cbSize;
  int      iBorderWidth;
  int      iScrollWidth;
  int      iScrollHeight;
  int      iCaptionWidth;
  int      iCaptionHeight;
  LOGFONTA lfCaptionFont;
  int      iSmCaptionWidth;
  int      iSmCaptionHeight;
  LOGFONTA lfSmCaptionFont;
  int      iMenuWidth;
  int      iMenuHeight;
  LOGFONTA lfMenuFont;
  LOGFONTA lfStatusFont;
  LOGFONTA lfMessageFont;
  int      iPaddedBorderWidth;
} NONCLIENTMETRICSA, *PNONCLIENTMETRICSA, *LPNONCLIENTMETRICSA;

メンバー

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 で実行されている場合は、 を呼び出す前に NONCLIENTMETRICS 構造体の cbSize メンバーから iPaddedBorderWidth メンバーのサイズを減算します。SystemParametersInfo 関数。

注意

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

要件

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

こちらもご覧ください

Logfont

SystemParametersInfo