COleControlSite::CreateControl

Artigo
02/25/2013

Cria um controle ActiveX, hospedado pelo objeto de COleControlSite .

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 da janela que representa o controle.
clsid
A identificação exclusiva da classe do controle.
lpszWindowName
Um ponteiro para o texto a ser exibido no controle.Defina o valor da propriedade de legenda ou o texto de winodw (se houver).
dwStyle
Estilos do windows.Os estilos disponíveis são listados na seção de Comentários .
rect
Especifica o tamanho e a posição do controle.Pode ser um objeto de CRect ou uma estrutura de RECT .
nID
Especifica a identificação da janela filho do controle
pPersist
Um ponteiro para CFile que contém o estado persistente para o controle.O valor padrão é NULO, indicando que o controle se inicializa sem restaurar seu estado de qualquer armazenamento persistente.Se não NULO, deve ser um ponteiro para CFile- o objeto derivado que contém os dados persistentes do controle, na forma de um fluxo ou um armazenamento.Esses dados podem ter sido salvo em uma ativação anterior do cliente.CFile pode conter outros dados, mas deve ter o ponteiro de leitura-gravação definido para o primeiro byte de dados persistentes no momento da chamada a CreateControl.
bStorage
Indica se os dados em pPersist devem ser interpretados como IStorage ou de IStream .Se os dados são pPersist em um armazenamento, bStorage deve ser Verdadeiro.Se os dados são pPersist em um fluxo, bStorage deve ser Falso.o valor padrão é Falso.
bstrLicKey
Dados opcionais de chave de licença.Esses dados são necessárias somente criando controles que exigem uma chave de licença de tempo de execução.Se o controle suporta licenciamento, você deve fornecer uma chave de licença para criação de controles para obterá êxito.o valor padrão é NULO.
ppt
Um ponteiro a estrutura de POINT que contém o canto superior esquerdo do controle.O tamanho do controle é determinado pelo valor de psize.ppt e psize valores é um método opcional para especificar o tamanho e posiciona o opf o controle.
psize
Um ponteiro a estrutura de TAMANHO que contém o tamanho do controle.O canto superior esquerdo é determinado pelo valor de ppt.ppt e psize valores é um método opcional para especificar o tamanho e posiciona o opf o controle.

Valor de retorno

Um valor padrão de HRESULT .

Comentários

Somente um subconjunto dos sinalizadores de dwStyle do windows é suportado por CreateControl:

WS_VISIBLE cria uma janela que é inicialmente visível.Necessário se você deseja que o controle seja visível imediatamente, como janelas comuns.
WS_DISABLED cria uma janela que é desativada inicialmente.Uma janela desativada não pode receber entrada do usuário.Pode ser definido se o controle tem uma propriedade ativado.
WS_BORDER cria uma janela com um fino- linha borda.Pode ser definido se o controle tem uma propriedade de BorderStyle.
WS_GROUP especifica o primeiro controle de um grupo de controles.O usuário pode alterar o foco do teclado de um controle no grupo a seguir usando as teclas de direção.Todos os controles definidos pelo estilo de WS_GROUP após o primeiro controle pertencem ao mesmo grupo.O próximo controle com o estilo de WS_GROUP termina o grupo e enfia o grupo seguir.
WS_TABSTOP especifica um controle que pode receber o foco do teclado quando o usuário pressiona a tecla TAB.Pressionando as alterações de tecla TAB o foco do teclado para o próximo controle de estilo de WS_TABSTOP .