COleControlContainer::CreateControl

Crea un control ActiveX, hospedado en el objeto especificado de 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 
);

Parámetros

• pWndCtrl
  Un puntero al objeto de la ventana que representa el control.

• clsid
  Identificador único de la clase del control.

• lpszWindowName
  Un puntero al texto que se mostrará en el control.Establece el valor de leyenda o la propiedad text (si existe).Si NULL, la leyenda del control o la propiedad de texto no cambia.

• dwStyle
  estilos de Windows.Los estilos disponibles se muestran en la sección de Comentarios .

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

• nID
  Especifica el identificador de la ventana secundaria de control

• pPersist
  Un puntero a CFile que contiene el estado persistente para el control.El valor predeterminado es NULL, que indica que el control se inicializa por sí mismo sin restaurar el estado de cualquier almacenamiento persistente.Si no NULL, debe ser un puntero a CFile- el objeto derivado que contiene datos persistentes de control, en forma de secuencia o almacenamiento.Estos datos podría haberse guardar en una activación anterior del cliente.CFile puede contener otros datos, pero debe hacer el puntero de lectura y escritura establecer el primer byte de datos persistentes en el momento de la llamada a CreateControl.

• bStorage
  indica si los datos en pPersist se deben interpretar como IStorage o datos de IStream .Si los datos de pPersist es un almacén, bStorage debe ser TRUE.Si los datos de pPersist es una secuencia, bStorage debe ser FALSO.el valor predeterminado es FALSO.

• bstrLicKey
  Datos opcionales de la clave de licencia.Estos datos se sólo necesita para crear controles que requieren una clave de licencia en tiempo de ejecución.Si el control admite la autorización, debe proporcionar una clave de licencia para la creación de controles para funcionar correctamente.el valor predeterminado es NULL.

• ppNewSite
  Un puntero al sitio del control existente que hospeda el control que se está creando.El valor predeterminado es NULL, que indica que un nuevo sitio de control automáticamente se creará y asociar al nuevo control.

• ppt
  Un puntero a una estructura de puntos que contiene la esquina superior izquierda del control.El tamaño del control está determinado por el valor de psize.ppt y psize valores es un método opcional de especificar el tamaño y posición del control.

• psize
  Un puntero a una estructura de CALIBRE que contiene el tamaño del control.La esquina superior izquierda viene determinada por el valor de ppt.ppt y psize valores es un método opcional de especificar el tamaño y posición del control.

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

Sólo un subconjunto de los indicadores de Windows dwStyle es compatible con CreateControl:

• WS_VISIBLE crea una ventana que se muestra inicialmente.Se requiere si desea que el control sea visible inmediatamente, como las ventanas normales.

• WS_DISABLED crea una ventana que se deshabilite inicialmente.Una ventana deshabilitado no puede recibir datos proporcionados por el usuario.Puede establecerse en si el control tiene una propiedad enabled.

• WS_BORDER crea una ventana con un borde de la fino-línea.Puede establecerse en 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 en un control del grupo al siguiente con las teclas de dirección.Todo controla definido con el estilo de SE después del primer control pertenece al mismo grupo.El control siguiente con el estilo de SE finaliza el grupo e inicie el grupo siguiente.

• WS_TABSTOP especifica un control que puede recibir el foco de teclado cuando el usuario presiona la tecla TABULADOR.Presione los cambios de tecla TAB el foco de teclado al siguiente control de estilo de WS_TABSTOP .

Utilice la segunda sobrecarga para crear controles valor por defecto-clasificados.

Requisitos

encabezado: afxocc.h

Vea también

Referencia

Clase de COleControlContainer

Gráfico de jerarquía