REBARBANDINFOW 構造体 (commctrl.h)

[アーティクル]
08/22/2023

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

構文

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」を参照)、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 は水平方向の測定です。

Note

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

要件


サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	commctrl.h

次の方法で共有

REBARBANDINFOW 構造体 (commctrl.h)

構文

メンバー

解説

要件

フィードバック

その他のリソース