CWnd::CreateControl

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

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

Valor devuelto

Distinto de cero si es correcto; caso contrario 0.

Parámetros

lpszClass

Esta cadena puede contener OLE "nombre corto" (ProgID) para la clase, por ejemplo, "CIRC3.Circ3Ctrl.1 ". El nombre debe coincidir con el mismo nombre registrado por el control. Por otra parte, la cadena puede contener el formato de cadena de un CLSID, contenida en las llaves, por ejemplo, "{9DBAFCCF-592F-101B-85CE-00608CEC297B}". En cualquier caso, métodos CreateControl convierte la cadena en el ID de clase correspondiente.

lpszWindowName

Un puntero para el texto que se muestra en el control. Establece el valor de la propiedad del control título o texto (si existe). Si NULL, el control del título o no se cambia la propiedad Text.

dwStyle

Estilos de Windows. Los estilos disponibles se enumeran en comentarios.

rect

Especifica la posición y el tamaño del control. Puede ser un objeto CRect o una estructura RECT.

pParentWnd

Especifica la ventana del control primario. No debe ser nulo.

nID

Especifica el ID del control.

pPersist

Un puntero a un CFile que contiene el estado persistente para el control. El valor predeterminado es NULL, que indica que el control inicializa sin restaurar su estado desde cualquier almacenamiento persistente. Si no nulo, debe ser un puntero a un CFile-objeto que contiene los datos del control persistentes, en forma de una secuencia o un almacenamiento derivado. Estos datos podrían han sido guardados en una activación anterior del cliente. El CFile puede contener otros datos, pero debe haber su puntero de lectura / escritura establecida en el primer byte de datos persistentes en el momento de la llamada a métodos CreateControl.

bStorage

Indica si los datos de pPersist deben ser interpretados como los datos de almacenamiento o IStream. Si los datos de pPersist están un almacenamiento de información, bStorage debe ser verdadero. Si los datos de pPersist están una secuencia, bStorage debe ser falsa. El valor predeterminado es FALSE.

bstrLicKey

Datos clave de licencia opcional. Esta información es necesaria sólo para crear controles que requieren una clave de licencia de tiempo de ejecución. Si el control admite la licencia, debe proporcionar una clave de licencia para la creación del control para triunfar. El valor predeterminado es NULL.

clsid

El ID de clase exclusivo del control.

Observaciones

Utilice esta función miembro para crear un control OLE que estarán representado en el programa MFC por un objeto CWnd . Métodos CreateControl es un análogo directo de la función de CWnd , que crea la ventana para un CWnd. Métodos CreateControl crea un control OLE en lugar de una ventana normal.

Sólo un subconjunto de las banderas de dwStyle de Windows son compatibles con métodos CreateControl:

• WS_VISIBLE   Crea una ventana que aparece al principio. Requerido si desea el control a ser visibles inmediatamente, como Windows ordinarios.
  
  
• WS_DISABLED   Crea una ventana que inicialmente está deshabilitada. Una ventana deshabilitada no puede recibir entradas del usuario. Se puede definir si el control tiene una propiedad Enabled.
  
  
• WS_BORDER   Crea una ventana con un borde de línea delgada. Se puede definir si el control tiene una propiedad BorderStyle.
  
  
• WS_GROUP   Especifica el primer control de un grupo de controles. El usuario puede cambiar el foco de teclado de un control en el grupo a la siguiente mediante las teclas de dirección. Todos los controles definidos con el estilo WS_GROUP tras el primer control pertenecen al mismo grupo. El siguiente control con el estilo WS_GROUP termina el grupo y comienza el siguiente grupo.
  
  
• WS_TABSTOP   Especifica un control que pueda recibir el foco de teclado cuando el usuario presiona la tecla TAB. Presionar la tecla TAB cambia el foco de teclado al siguiente control del estilo WS_TABSTOP.

Visión General de CWnd |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;  En la Guía del programador de Visual C++: temas de Control ActiveX