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


CHeaderCtrl::Create

Создает элемент управления заголовка и вложение его к объекту CHeaderCtrl.

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

Параметры

  • dwStyle
    Задает стиль заголовка элемента управления.Описание стилей элементов управления заголовков см. в разделе Стили заголовка элемента управления в Windows SDK.

  • rect
    Определяет размер и положение элемента управления заголовка.Может быть либо объектом CRect или структурой RECT.

  • pParentWnd
    Задает родительское окно элемента управления заголовка, обычно CDialog.Это не должно быть NULL.

  • nID
    Определяет идентификатор элемента управления заголовка

Возвращаемое значение

Ненулевой если инициализация прошла успешно; в противном случае – нуль.

Заметки

Построении объект CHeaderCtrl в шагах 2.Во-первых, вызовите конструктор, и затем вызовите Создать, который создает элемент управления заголовка и вложение его к объекту CHeaderCtrl.

Помимо стилей элементов управления заголовков, можно использовать следующие стили общего элемента управления, чтобы определить как элемент управления заголовка располагает и изменяет размер (см. Стили стандартных элементов управления дополнительные сведения).

  • CCS_BOTTOM вызывает элемент управления располагаться в нижней части клиентской области родительского окна и задает ширину, чтобы быть такими же, как ширина родительского окна.

  • CCS_NODIVIDER предотвращает выделение цветом 2 - точки из выписанным в верхней части элемента управления.

  • CCS_NOMOVEY вызывает элемент управления, размер и перемещение по горизонтали, по вертикали, но не в ответ на сообщение WM_SIZE.Если стиль CCS_NORESIZE используется, то этот стиль не применяется.Управления заголовка имеющие это по умолчанию стиля.

  • CCS_NOPARENTALIGN предотвращает элемент управления автоматически переместить в верхней или нижней части родительского окна.Вместо этого элемент управления сохраняет свою позицию в родительское окно, несмотря на изменения размера родительского окна.Если стиль CCS_TOP или CCS_BOTTOM также используется, которым регулируется высота значение по умолчанию, но положение и ширина остаются неизменными.

  • CCS_NORESIZE предотвращает элемент управления от использования по умолчанию ширина и высота параметра свой исходный размер или новый размер.Вместо этого элемент управления использует ширину и высоту, определенные в запросе для создания или изменения размера.

  • CCS_TOP вызывает элемент управления располагаться вверху клиентскую область родительского окна и задает ширину, чтобы быть такими же, как ширина родительского окна.

Также можно применить следующие стили окна в элемент управления заголовка (см. стили окна дополнительные сведения).

  • Создает WS_CHILD дочернее окно.Не может использоваться с учетом WS_POPUP.

  • WS_VISIBLE Создает окно, которое изначально видимым.

  • WS_DISABLED Создает окно, которое изначально отключен.

  • WS_GROUP Определяет первый элемент управления группы в составе элементы управления, в которых пользователь может перемещать из одного элемента управления к следующему с клавишами со стрелками.Все элементы управления, указанные с учетом WS_GROUP после первого элемента управления, принадлежащие той же группе.Следующий элемент управления со стилем WS_GROUP завершить группа стилей и запустить следующую группу (то есть одна группа завершения, где начинается следующее).

  • WS_TABSTOP Определяет одно из множества элементов управления, с помощью которых пользователь может перемещать с помощью клавиши TAB.Клавиши TAB пользователь перемещается к следующему элементу управления заданным стилем WS_TABSTOP.

Если необходимо использовать расширенные стили окна с элементом управления, вызовите CreateEx вместо Создать.

Пример

// pParentWnd is a pointer to the parent window.
m_myHeaderCtrl.Create(WS_CHILD | WS_VISIBLE | HDS_HORZ,
   CRect(10, 10, 600, 50), pParentWnd, 1);

Требования

Header: afxcmn.h

См. также

Ссылки

Класс CHeaderCtrl

Диаграмма иерархии

CHeaderCtrl::CHeaderCtrl