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 de retorno

Diferente de zero se bem-sucedida; caso contrário 0.

Parâmetros

lpszClass

Essa Cadeia de caracteres pode conter o OLE "nome abreviado" (ProgID) para a classe, por exemplo, "CIRC3.Circ3Ctrl.1 ". O nome deve coincidir com o mesmo nome registrado pelo controle. Como alternativa, a Cadeia de caracteres pode conter o formulário de Cadeia de caracteres de um CLSID, contido entre chaves, por exemplo, "{9DBAFCCF-592F-101B-85CE-00608CEC297B}". Em ambos os casos, CreateControl converte a Cadeia de caracteres para a identificação de classe correspondente.

lpszWindowName

Um ponteiro para o texto a ser exibido no Controlarar. Define o valor da propriedade texto ou legenda do Controlarar (se houver). Se NULL, o controle da legenda ou texto propriedade não é alterado.

dwStyle

Estilos do Windows. Os estilos disponíveis são listados em comentários.

rect

Especifica tamanho e posição do Controlarar. Ele pode ser um objeto CRect ou uma estrutura RECT.

pParentWnd

Especifica a janela pai do controle. Não pode ser Nulo.

nID

Especifica a identificação do Controlarar.

pPersist

Um ponteiro para um CFile contendo o estado persistente para o Controlarar. O valor padrão é NULL, indicando que o Controlarar inicializa por si próprio sem restaurar seu estado de qualquer armazenamento persistente. Se não for NULL, ele deve ser um ponteiro para um CFile-derivado objeto que contém os dados do controle persistente, sob a forma de um fluxo ou um armazenamento. Estes dados poderiam ter sido salvas em uma ativação anterior do cliente. O CFile pode conter outros dados, mas deve ter seu ponteiro de leitura definido para o primeiro byte de dados persistentes no momento da chamada para CreateControl.

bStorage

Indica se os dados no pPersist devem ser interpretados como dados IStorage ou IStream. Se os dados no pPersist forem um armazenamento, bStorage deve ser verdadeiro. Se os dados no pPersist forem um fluxo, bStorage deve ser FALSE. O valor padrão é FALSE.

bstrLicKey

Dados de chave licença opcional. Este dados é necessária somente para criar controles que exigem uma chave de licença de tempo de execução. Se o Controlarar suporta licenciamento, você deve fornecer uma chave de licença para a criação do Controlarar para ser bem sucedida. O valor padrão é Nulo.

clsid

A exclusivo identificação de classe do controle.

Observações

Use esta função de membro para criar um Controlarar OLE que estarão representado no programa MFC por um objeto CWnd . CreateControl é um análogo direto da função CWnd:: Create , que cria a janela para um CWnd. CreateControl cria um Controlarar OLE em vez de uma janela normal.

Apenas um subconjunto dos sinalizadores de dwStyle Windows são suportados para CreateControl:

• &Nbsp WS_VISIBLE;  Cria uma janela que está visível inicialmente. Necessário se você deseja que o controle seja visível imediatamente, como o windows ordinários.
  
  
• WS_DISABLED   Cria uma janela que inicialmente está desativada. Uma janela desabilitada não pode receber entrada do usuário. Pode ser definido se o Controlarar tiver uma propriedade Enabled.
  
  
• WS_BORDER   Cria uma janela com uma borda de linha fina. Pode ser definido se o Controlarar possui uma propriedade 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 para o próximo usando as teclas de direção. Todos os controles definidos com o estilo WS_GROUP após o primeiro controle pertencem ao mesmo grupo. O Avançar Controlarar com o estilo WS_GROUP termina o grupo e inicia o Avançar grupo.
  
  
• WS_TABSTOP   Especifica um Controlarar que pode receber o foco do teclado quando o usuário pressiona a tecla TAB. Pressionando a tecla TAB altera o foco do teclado para o Avançar Controlarar do estilo WS_TABSTOP.

|&Nbsp CWnd visão geral ; Membros de classe | Gráfico de hierarquia

Consulte tambémnbsp;  &No Guia do programador do Visual C++: controle ActiveX tópicos