Структура 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

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

Значение Значение
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 являются вертикальными измерениями, а cyMinChild — горизонтальным измерением.

Примечание

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

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть commctrl.h