Структура REBARBANDINFOW (commctrl.h)

Статья
11/18/2024

Содержит сведения, определяющие полосу в элементе управления 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

Флаги, указывающие, какие члены этой структуры допустимы или должны быть заполнены. Это значение может быть сочетанием следующих значений:

Ценность	Значение
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 указывает фоновую растровую карту, эти элементы игнорируются. По умолчанию группа будет использовать цвет фона набора элементов управления rebar с сообщением RB_SETBKCOLOR. Если здесь указан цвет фона, вместо этого будет использоваться этот цвет фона.

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), элемент управления перекладинка попытается сделать полосу этой шириной.

lParam

Тип: LPARAM

версии 4.71. Определяемое приложением значение.

cxHeader

Тип: UINT

версии 4.71. Размер заголовка полосы в пикселях. Заголовок полосы — это область между краем полосы и краем дочернего окна. Это область, в которой отображаются текст и изображения, если они указаны. Если это значение указано, оно переопределит обычные измерения заголовков, вычисляемые элементом управления для полосы.

rcChevronLocation

Тип: RECT

версии 6. Расположение шеврона.

uChevronState

Тип: UINT

версии 6. Сочетание констант состояния объекта .

Замечания

cxMinChild, cyMinChildи cx содержат сведения о измерениях относительно ориентации элемента управления. То есть для горизонтального элемента управления перебором cxMinChild и cx являются горизонтальными измерениями и cyMinChild является вертикальным измерением. Однако если элемент управления использует стиль CCS_VERT, cxMinChild и cx cx являются вертикальными измерениями и cyMinChild является горизонтальным измерением.

Заметка

Заголовок commctrl.h определяет REBARBANDINFO как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
заголовка	commctrl.h

Поделиться через

Структура REBARBANDINFOW (commctrl.h)

Синтаксис

Члены

Замечания

Требования

Обратная связь

Дополнительные ресурсы