共用方式為

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 版。 即使它是 Rebar 中唯一的帶狀帶，樂隊還是一律會有重設大小的抓地。
RBBS_HIDDEN
 無法看見帶狀。
RBBS_NOGRIPPER

4.71 版。 即使鋼筋中有一個以上的樂隊，樂隊永遠不會有一個重設大小夾。
RBBS_USECHEVRON

5.80 版。 如果帶小於 cxIdeal，則顯示>形箭號按鈕。
RBBS_VARIABLEHEIGHT

4.71 版。 帶狀線可以由 Rebar 控件重設大小;cyIntegral 和 cyMaxChild 會影響 rebar 調整帶大小的方式。
RBBS_NOVERT
 垂直時不要顯示。
RBBS_HIDETITLE
 隱藏樂隊標題。
RBBS_TOPALIGN
 將頻帶保持在頂端列。

clrFore

類型：COLORREF

帶狀前景色彩。

clrBack

類型：COLORREF

帶狀背景色彩。 如果 hbmBack 指定背景點圖，則會忽略這些成員。 根據預設，帶狀線會使用以 RB_SETBKCOLOR 訊息設定的 Rebar 控件背景色彩。 如果在此指定背景色彩，則會改用此背景色彩。

lpText

類型：LPTSTR

緩衝區的指標，其中包含帶狀結構的顯示文字。 如果從控件要求帶狀資訊，且RBBIM_TEXT是在 fMask中指定 ，則必須將此成員初始化為將接收文字的緩衝區位址。

cch

類型：UINT

lpText的緩衝區大小，以位元組為單位。 如果未從控件要求資訊，則會忽略這個成員。

iImage

類型：int

任何應該顯示在頻帶中之影像的以零起始的索引。 映射清單是使用 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 成員會提供相對於控件方向的維度資訊。 也就是說，針對水準 Rebar 控件，cxMinChild 和 cx 是水準度量，而 cyMinChild 是垂直度量。 不過，如果控件使用 CCS_VERT 樣式，cxMinChild 和 cx 是垂直 度量，而 cyMinChild 為水準度量。

注意

commctrl.h 標頭會根據 UNICODE 預處理器常數的定義，將 REBARBANDINFO 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 commctrl.h