英語で読む

次の方法で共有

REBARBANDINFOW 構造体 (commctrl.h)

  • [アーティクル]

鉄筋コントロールの帯を定義する情報が含まれます。

構文

typedef struct tagREBARBANDINFOW {
  UINT     cbSize;
  UINT     fMask;
  UINT     fStyle;
  COLORREF clrFore;
  COLORREF clrBack;
  LPWSTR   lpText;
  UINT     cch;
  int      iImage;
  HWND     hwndChild;
  UINT     cxMinChild;
  UINT     cyMinChild;
  UINT     cx;
  HBITMAP  hbmBack;
  UINT     wID;
  UINT     cyChild;
  UINT     cyMaxChild;
  UINT     cyIntegral;
  UINT     cxIdeal;
  LPARAM   lParam;
  UINT     cxHeader;
  RECT     rcChevronLocation;
  UINT     uChevronState;
} REBARBANDINFOW, *LPREBARBANDINFOW;

メンバーズ

cbSize

型: UINT

この構造体のサイズ (バイト単位)。 アプリケーションでは、この構造体のアドレスをパラメーターとして使用するメッセージを送信する前に、このメンバーを入力する必要があります。

fMask

型: UINT

この構造体のどのメンバーが有効か、または入力する必要があることを示すフラグ。 この値には、次の組み合わせを指定できます。

価値 意味
RBBIM_BACKGROUND
 hbmBack メンバーが有効であるか、設定されている必要があります。
RBBIM_CHILD
 hwndChild メンバーが有効であるか、設定されている必要があります。
RBBIM_CHILDSIZE
 cxMinChild、cyMinChild、cyChild、cyMaxChild、および cyIntegral メンバーは有効であるか、設定する必要があります。
RBBIM_COLORS
 clrFore および clrBack メンバーは有効であるか、設定する必要があります。
RBBIM_HEADERSIZE

バージョン 4.71。 cxHeader メンバーが有効であるか、設定する必要があります。
RBBIM_IDEALSIZE

バージョン 4.71。 cxIdeal メンバー 有効であるか、設定する必要があります。
RBBIM_ID
 wID メンバーは有効であるか、設定する必要があります。
RBBIM_IMAGE
 iImage メンバーは有効であるか、設定する必要があります。
RBBIM_LPARAM

バージョン 4.71。 lParam メンバーは有効であるか、設定する必要があります。
RBBIM_SIZE
 cx メンバーは有効であるか、設定する必要があります。
RBBIM_STYLE
 fStyle メンバーは有効であるか、設定する必要があります。
RBBIM_TEXT
 lpText メンバーが有効であるか、設定する必要があります。
RBBIM_CHEVRONLOCATION
 rcChevronLocation メンバーが有効であるか、設定する必要があります。
RBBIM_CHEVRONSTATE
 uChevronState メンバーは有効であるか、設定する必要があります。

fStyle

型: UINT

帯のスタイルを指定するフラグ。 この値には、次の組み合わせを指定できます。

価値 意味
RBBS_BREAK
 バンドは新しいラインにあります。
RBBS_CHILDEDGE
 バンドには、子ウィンドウの上部と下部にエッジがあります。
RBBS_FIXEDBMP
 バンドのサイズを変更しても、背景ビットマップは移動しません。
RBBS_FIXEDSIZE
 バンドのサイズを設定できません。 このスタイルでは、サイズ変更グリップはバンドに表示されません。
RBBS_GRIPPERALWAYS

バージョン 4.71。 バンドは、鉄筋の唯一のバンドである場合でも、常にサイズ変更グリップを持っています。
RBBS_HIDDEN
 バンドは表示されません。
RBBS_NOGRIPPER

バージョン 4.71。 鉄筋に複数のバンドがある場合でも、バンドにサイズ変更グリップはありません。
RBBS_USECHEVRON

バージョン 5.80。 バンドが cxIdealよりも小さい場合は、シェブロン ボタン 表示します。
RBBS_VARIABLEHEIGHT

バージョン 4.71。 バンドのサイズは、鉄筋コントロールで変更できます。cyIntegral と cyMaxChild 、鉄筋のバンドのサイズ変更方法に影響します。
RBBS_NOVERT
 垂直方向の場合は表示されません。
RBBS_HIDETITLE
 バンド タイトルを非表示のままにします。
RBBS_TOPALIGN
 バンドを一番上の行に保持します。

clrFore

型: COLORREF

前景色を帯びます。

clrBack

型: COLORREF

バンドの背景色。 hbmBack バックグラウンド ビットマップを指定した場合、これらのメンバーは無視されます。 既定では、バンドは、RB_SETBKCOLOR メッセージと共に設定された鉄筋コントロールの背景色を使用します。 ここで背景色を指定すると、代わりにこの背景色が使用されます。

lpText

型: LPTSTR

バンドの表示テキストを含むバッファーへのポインター。 コントロールからバンド情報が要求されていて、RBBIM_TEXTが fMask指定されている場合、このメンバーはテキストを受け取るバッファーのアドレスに初期化する必要があります。

cch

型: UINT

lpTextバッファーのサイズ (バイト単位)。 コントロールから情報が要求されていない場合、このメンバーは無視されます。

iImage

型: int

バンドに表示する画像の 0 から始まるインデックス。 イメージ リストは、RB_SETBARINFO メッセージを使用して設定されます。

hwndChild

型: HWND

バンドに含まれている子ウィンドウ (存在する場合) へのハンドル。

cxMinChild

型: UINT

子ウィンドウの最小幅 (ピクセル単位)。 バンドのサイズをこの値より小さくすることはできません。

cyMinChild

型: UINT

子ウィンドウの最小高さ (ピクセル単位)。 バンドのサイズをこの値より小さくすることはできません。

cx

型: UINT

バンドの長さ (ピクセル単位)。

hbmBack

型: HBITMAP

このバンドの背景として使用されるビットマップを処理します。

wID

型: UINT

カスタム描画通知メッセージのこのバンドを識別するためにコントロールが使用する UINT 値。

cyChild

型: UINT

バージョン 4.71。 バンドの初期高さ (ピクセル単位)。 RBBS_VARIABLEHEIGHT スタイルが指定されていない限り、このメンバーは無視されます。

cyMaxChild

型: UINT

バージョン 4.71。 バンドの最大高さ (ピクセル単位)。 RBBS_VARIABLEHEIGHT スタイルが指定されていない限り、このメンバーは無視されます。

cyIntegral

型: UINT

バージョン 4.71。 バンドを拡大または縮小できるステップ値 (ピクセル単位)。 バンドのサイズを変更すると、この値で指定された手順でサイズが変更されます。 RBBS_VARIABLEHEIGHT スタイルが指定されていない限り、このメンバーは無視されます。

cxIdeal

型: UINT

バージョン 4.71。 バンドの理想的な幅 (ピクセル単位)。 バンドが理想的な幅に最大化されている場合 (RB_MAXIMIZEBAND参照)、鉄筋コントロールはバンドをこの幅にしようとします。

lParam

型: LPARAM

バージョン 4.71。 アプリケーション定義の値。

cxHeader

型: UINT

バージョン 4.71。 バンドのヘッダーのサイズ (ピクセル単位)。 バンド ヘッダーは、バンドの端と子ウィンドウの端の間の領域です。 これは、バンド テキストと画像が指定されている場合に表示される領域です。 この値を指定すると、コントロールがバンドに対して計算する通常のヘッダー ディメンションがオーバーライドされます。

rcChevronLocation

型: RECT

バージョン 6を します。 シェブロンの位置。

uChevronState

型: UINT

バージョン 6を します。 オブジェクト状態定数の組み合わせ。

備考

cxMinChild、cyMinChild、および cx メンバーは、コントロールの向きを基準にしたディメンションに関する情報を提供します。 つまり、水平鉄筋コントロールの場合、cxMinChild と cx は水平方向の測定値であり、cyMinChild は垂直方向の測定値です。 ただし、コントロールで CCS_VERT スタイルを使用する場合、cxMinChild と cx は垂直方向の測定値であり、cyMinChild は水平方向の測定値です。

注意

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー commctrl.h