Partilhar via


COleControlContainer::CreateControl

Cria um controle ActiveX, hospedado pelo 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
    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 texto do controle (se houver).Se a propriedade de NULO, da legenda de controle ou de texto não é alterada.

  • 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.

  • ppNewSite
    Um ponteiro para o site existente do controle que hospedará o controle sendo criado.O valor padrão é NULO, indicando que um novo site do controle automaticamente será criada e anexada ao novo controle.

  • 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 posição do 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 posição do controle.

Valor de retorno

Diferente de zero se com êxito; se não 0.

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 .

Use a segunda sobrecarga para criar controles opção- dimensionados.

Requisitos

Cabeçalho: afxocc.h

Consulte também

Referência

Classe de COleControlContainer

Gráfico de hierarquia