REBARBANDINFOW 結構 (commctrl.h)
包含定義 Rebar 控制項中帶的資訊。
語法
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
旗標,指出此結構的成員有效或必須填入。 此值可以是下列各項的組合:
值 | 意義 |
---|---|
|
hbmBack成員有效或必須設定。 |
|
hwndChild成員有效或必須設定。 |
|
cxMinChild、cyMinChild、cyChild、cyMaxChild和cyIntegral成員有效或必須設定。 |
|
clrFore和clrBack成員有效或必須設定。 |
|
4.71 版。 cxHeader成員有效或必須設定。 |
|
4.71 版。 cxIdeal成員有效或必須設定。 |
|
wID成員有效或必須設定。 |
|
iImage成員有效或必須設定。 |
|
4.71 版。 lParam成員有效或必須設定。 |
|
cx成員有效或必須設定。 |
|
fStyle成員有效或必須設定。 |
|
lpText成員有效或必須設定。 |
|
rcChevronLocation成員有效或必須設定。 |
|
uChevronState成員有效或必須設定。 |
fStyle
類型: UINT
指定帶狀樣式的旗標。 此值可以是下列各項的組合:
值 | 意義 |
---|---|
|
帶狀線位於新行上。 |
|
訊號區具有子視窗頂端和底部的邊緣。 |
|
背景點陣圖在調整帶大小時不會移動。 |
|
無法調整訊號。 使用此樣式時,調整大小底線不會顯示在帶狀區上。 |
|
4.71 版。 即使其是 Rebar 中唯一的帶狀區,此帶一律會有調整大小底線。 |
|
不會顯示帶狀。 |
|
4.71 版。 即使 Rebar 中有一個以上的帶狀區,帶狀線永遠不會有調整大小底線。 |
|
5.80 版。 如果帶小於 cxIdeal,則顯示形箭號按鈕。 |
|
4.71 版。 Rebar 控制項可以調整訊號範圍的大小; cyIntegral 和 cyMaxChild 會影響 Rebar 調整大小範圍的方式。 |
|
垂直時不顯示。 |
|
讓頻外標題保持隱藏。 |
|
將帶狀區保留在頂端列。 |
clrFore
類型: COLORREF
帶狀前景色彩。
clrBack
類型: COLORREF
帶狀背景色彩。 如果 hbmBack 指定背景點陣圖,則會忽略這些成員。 根據預設,帶會使用設定 RB_SETBKCOLOR訊息之 Rebar 控制項的背景色彩。 如果在這裡指定背景色彩,則會改用此背景色彩。
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
備註
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 |