CWnd::CreateControl

BOOL CWnd::CreateControl (LPCTSTR lpszClass, LPCTSTR lpszWindowName, DWORD dwStyleconst RECTamp;RectCWnd *pParentWndUINTnIDCFile *pPersist= NULL, BOOLbStorage= F&ALSE, BSTRbstrLicKey = NULL );

BOOL CWnd::CreateControl (REFCLSID clsid, LPCTSTR lpszWindowName, DWORD dwStyleconst RECTamp;RectCWnd *pParentWndUINTnIDCFile *pPersist= NULL, BOOLbStorage= F&ALSE, BSTRbstrLicKey = NULL );

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

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

Параметры

lpszClass

Эта строка может содержать OLE «краткое название» (ProgID) для класса, например, "CIRC3.Circ3Ctrl.1 ". Имя должно соответствовать имя зарегистрированным элементом управления. Кроме того строка может содержать строковую форму CLSID, заключенных в скобки, например, "{9DBAFCCF-592F-101B-85CE-00608CEC297B}". В любом случае Метод CreateControl преобразует строку в соответствующий Идентификатор класса.

lpszWindowName

Указатель на текст, который отображается в элементе управления. Устанавливает значение свойства заголовка или текста элемента управления (если таковой имеется). Если NULL, заголовок элемента управления или свойства Text не изменяется.

dwStyle

Стили Windows. Доступные стили перечислены в разделе Примечания.

rect

Определяет размер и положение элемента управления. Это может быть объект CRect или структуры Rect..

pParentWnd

Указывает родительского окна элемента управления. Он не должен быть НЕОПРЕДЕЛЕННЫМ.

nID

Указывает Идентификатор элемента управления.

pPersist

Указатель CFile , содержащие постоянного состояния для элемента управления. Значение по умолчанию — NULL, указывающее, что элемент управления инициализирует себя без восстановления свое состояние из постоянного хранилища. Если не NULL, он должен быть указателем CFile-производный объект, который содержит постоянных данных элемента управления в виде потока или хранения. Эти данные можно было бы спасти в предыдущей активации клиента. CFile может содержать другие данные, но должно иметь его для чтения записи указателя присвоено первый байт постоянных данных во время вызова Метод CreateControl.

bStorage

Указывает ли данные в pPersist , следует толковать как IStorage или IStream данных. Если данные в pPersist хранения, bStorage должно быть правдой. Если данные в pPersist поток, bStorage должно быть равно FALSE. Значение по умолчанию — FALSE.

bstrLicKey

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

clsid

Класса уникальный Идентификатор элемента управления.

Примечания

Используйте эту функцию-член для создания элемента управления OLE, который будет представлен в программы MFC CWnd объекте. Метод CreateControl является прямым аналогом функции CWnd::Create , которая создает окно для CWnd. Метод CreateControl создает элемента управления OLE вместо того, чтобы обычные окна.

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

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

Обзор CWnd |nbsp; Члены класса | Иерархическая схема

См. также   В Visual C++ программист руководство: темы элементов управления ActiveX