COleControlSite::CreateControl

Artigo
08/25/2010

Cria um controle ActiveX, hospedado pelo COleControlSite objeto.

virtual HRESULT CreateControl(
   CWnd* pWndCtrl,
   REFCLSID clsid,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const RECT& rect,
   UINT nID,
   CFile* pPersist = NULL,
   BOOL bStorage = FALSE,
   BSTR bstrLicKey = NULL 
);
virtual HRESULT 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 
);

Parâmetros

pWndCtrl
Um ponteiro para o objeto que representa o controle da janela.
clsid
ID exclusiva de classe do controle.
lpszWindowName
Um ponteiro para o texto a ser exibido no controle.Define o valor da propriedade legenda ou Texto da winodw (se houver).
dwStyle
Estilos do Windows.Os estilos disponível são listados sob o Comentários seção.
rect
Especifica o dimensionar e posição do controle.Pode ser qualquer um CRect objeto ou um RECT estrutura.
nID
Especifica a ID da janela. filho do controle
pPersist
Um ponteiro para um CFile que contém o estado persistente para o controle. O valor padrão é NULO, indicando que o controle inicializa por si próprio sem restaurar o estado de qualquer armazenamento persistente.Se não NULO, ele deve ser um ponteiro para um CFile-derivados do objeto que contém os dados do controle persistente, na forma de um fluxo ou um armazenamento. Esses dados podem ter sido salvo em uma ativação anterior do cliente.The CFile pode conter outros dados, mas deve ter seu ponteiro de leitura-gravar conjunto o primeiro byte de dados persistentes no momento da telefonar para CreateControl.
bStorage
Indica se sistema autônomo dados em pPersist deve ser interpretado sistema autônomo IStorage ou IStream dados. Se os dados em pPersist é um armazenamento bStorage deve ser TRUE.Se os dados em pPersist é um fluxo bStorage deve ser FALSE.O valor padrão é FALSE.
bstrLicKey
Dados chave de licença opcional.Esses dados é necessária somente para criar controles que exigem uma chave de licença de time de execução.Se o controle suporta o licenciamento, você deve fornecer uma chave de licença para a criação do controle seja bem-sucedida.O valor padrão é NULO.
ppt
Um ponteiro para um PONTO estrutura que contém o canto superior esquerdo do controle.O dimensionar do controle é determinado pelo valor de psize.The ppt e psize valores são um método opcional de especificar o dimensionar e posicione opf o controle.
psize
Um ponteiro para um dimensionar estrutura que contém o dimensionar do controle.O canto superior esquerdo é determinado pelo valor de ppt. The ppt e psize valores são um método opcional de especificar o dimensionar e posicione opf o controle.

Valor de retorno

Um padrão HRESULT valor.

Comentários

Apenas um subconjunto do Windows dwStyle sinalizadores são suportados pelo CreateControl:

WS_VISIBLE Cria uma janela que está visível inicialmente.Obrigatório se você desejar que o controle seja visível imediatamente, como janelas comuns.
WS_DISABLED Cria uma janela inicialmente desabilitado.Uma janela desabilitado não pode receber entrada do usuário.Pode ser definida se o controle tem uma propriedade Enabled.
WS_BORDER Cria uma janela com uma borda de linha fina. É possível conjunto se o controle tem uma propriedade BorderStyle.
WS_GROUP Especifica o primeiro controle de um agrupar de controles.O usuário pode alterar o foco do teclado de um controle no agrupar para a próxima, use as teclas de direção.Todos os controles definidos com o WS_GROUP estilo após o primeiro controle pertencer ao agrupar do mesmo.O próximo controle com o WS_GROUP estilo termina o agrupar e começa o próximo agrupar.
WS_guiaSTOP Especifica um controle que pode receber o foco do teclado quando o usuário pressiona o tecla guia.Pressionar a tecla guia altera o foco do teclado para o próximo controle do WS_TABSTOP estilo.