COleControlContainer::CreateControl

Статья
02/20/2013

Создает элемент управления ActiveX, размещенный указанным объектом COleControlSite.

BOOL CreateControl(
   CWnd* pWndCtrl,
   REFCLSID clsid,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const RECT& rect,
   UINT nID,
   CFile* pPersist=NULL,
   BOOL bStorage=FALSE,
   BSTR bstrLicKey=NULL,
   COleControlSite** ppNewSite=NULL 
);
BOOL CreateControl(
   CWnd* pWndCtrl,
   REFCLSID clsid,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const POINT* ppt,
   const SIZE* psize,
   UINT nID,
   CFile* pPersist=NULL,
   BOOL bStorage=FALSE,
   BSTR bstrLicKey=NULL,
   COleControlSite** ppNewSite=NULL 
);

Параметры

pWndCtrl
Указатель на объект окна, представляющий элемент управления.
clsid
Уникальный идентификатор класса элемента управления.
lpszWindowName
Указатель на текст, отображаемый в элементе управления.Присваивает значение свойства заголовка и текста элемента управления (если есть).Если не изменен свойство NULL, заголовка элемента управления или текста.
dwStyle
Стили Windows.Доступные стили перечислены в разделе Примечания.
rect
Определяет размер и положение элемента управления.Может быть либо объектом CRect или структурой RECT.
nID
Определяет идентификатор дочернего окна элемента управления
pPersist
Указатель на CFile, содержащее постоянное состояние элемента управления.Значение по умолчанию NULL, указывающее, что элемент управления инициализирует без восстановления состояния из постоянного хранилища.Если не NULL, оно должно указатель на CFile- производный объект, содержащий данные элемента управления в форме или постоянных, потока или модели хранения.Эти данные могут быть сохранены в предыдущей активации клиента.CFile может содержать другие данные, но должно иметь свой указатель чтени- записи устанавливаться к первому байту постоянных данных во время вызова метода CreateControl.
bStorage
Указывает, должны ли данные в pPersist интерпретироваться как IStorage или данные IStream.Если данные в pPersist хранилище, то bStorage должно быть TRUE.Если данные в pPersist поток, bStorage должно быть FALSE.Значение по умолчанию FALSE.
bstrLicKey
Необязательные данные ключа лицензии.Эти данные не требуются только создание элементов управления, требующих ключа во время выполнения лицензии.Если элемент управления поддерживает лицензирования необходимо ввести ключ лицензии для создания элемента управления успешно.Значение по умолчанию NULL.
ppNewSite
Указатель к существующему сайту элемента управления, который будет размещение, создать элемент управления.Значение по умолчанию NULL, указывающее, что новый сайт элемента управления будет автоматически создать и вложить к новому элементу управления.
ppt
Указатель на структуру, содержащую POINT угол верхн- левого края элемента управления.Размер элемента управления определяется значением psize.ppt и psize значения необязательный метод указав размер и положение элемента управления.
psize
Указатель на структуру SIZE, содержащее размер элемента управления.Левый угол верхн- определяется значением ppt.ppt и psize значения необязательный метод указав размер и положение элемента управления.

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

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

Заметки

Только подмножество флагов Windows dwStyle поддерживается CreateControl:

WS_VISIBLE Создает окно, которое изначально видимым.Обязательный, если требуется элемент управления видимы сразу, как обычные окна.
WS_DISABLED Создает окно, которое изначально отключен.Отключенное окно не может получать входные данные от пользователя.Может быть установлено, если элемент управления имеет свойство enabled.
WS_BORDER создает окно с границей тонк- линии.Может быть установлено, если элемент управления имеет свойства BorderStyle.
WS_GROUP Определяет первый элемент управления группы в составе элементы управления.Пользователь может изменять фокус ввода от одного элемента управления в группе к следующему с помощью ключей направления.Все элементы управления, указанные с учетом WS_GROUP после первого элемента управления, принадлежащие той же группе.Следующий элемент управления со стилем WS_GROUP завершить группа и запустить следующую группу.
WS_TABSTOP Указывает элемент управления, который может получать фокус клавиатуры, когда пользователь нажимает клавишу TAB.Отжимающ изменения клавиши TAB фокус ввода к следующему элементу управления стиля WS_TABSTOP.

Используйте второй перегруженный метод для создания значения по умолчанию- указанных размеров элементов управления.

Требования

Header: afxocc.h

См. также

Ссылки

Класс COleControlContainer

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

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