REBARBANDINFOA 構造体 (commctrl.h)

  • [アーティクル]

Rebar コントロールのバンドを定義する情報が含まれます。

構文

typedef struct tagREBARBANDINFOA {
  UINT     cbSize;
  UINT     fMask;
  UINT     fStyle;
  COLORREF clrFore;
  COLORREF clrBack;
  LPSTR    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;
} REBARBANDINFOA, *LPREBARBANDINFOA;

メンバー

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。 バンドのサイズは、Rebar コントロールによって変更できます。 cyIntegral と cyMaxChild は、鉄筋のバンドのサイズを変更する方法に影響します。
RBBS_NOVERT
 垂直の場合は表示しません。
RBBS_HIDETITLE
 バンド タイトルを非表示のままにします。
RBBS_TOPALIGN
 バンドを一番上の行に保持します。

clrFore

種類: COLORREF

前景色を帯びます。

clrBack

種類: COLORREF

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

lpText

種類: LPTSTR

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

cch

型: UINT

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

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」を参照)、Rebar コントロールはバンドをこの幅にしようとします。

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 (デスクトップ アプリのみ)
Header commctrl.h