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 版。 即使 Rebar 中有一個以上的帶狀，此帶永遠不會有重設大小底框。
RBBS_USECHEVRON

5.80 版。 如果訊號範圍小於 cxIdeal，則顯示形箭號按鈕。
RBBS_VARIABLEHEIGHT

4.71 版。 Rebar 控件可以調整訊號範圍的大小; cyIntegral 和 cyMaxChild 會影響 Rebar 重設大小帶的方式。
RBBS_NOVERT
 垂直時不要顯示。
RBBS_HIDETITLE
 保持隱藏訊號標題。
RBBS_TOPALIGN
 將帶保持在頂端數據列。

clrFore

類型： COLORREF

帶狀前景色彩。

clrBack

類型： COLORREF

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

lpText

類型： LPTSTR

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

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

規格需求

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