O que é ATL API de Hospedagem?

ATL que hospeda API é o conjunto de funções que permite que qualquer janela atua como um recipiente de controles ActiveX.Essas funções podem para vincular estaticamente ou dinamicamente em seu projeto já que estão disponíveis como código-fonte e expostos por ATL90.dll.Funções de hospedagem são listadas na tabela abaixo.

Função

Descrição

AtlAxAttachControl

Cria um objeto host, conectá-lo a janela fornecida, então anexa um controle existente.

AtlAxCreateControl

Cria um objeto host, conectá-lo a janela fornecida, então carregá-lo um controle.

AtlAxCreateControlLic

Cria um controle ActiveX licenciado, inicializa-o, e hospedá-lo na janela especificada, semelhante a AtlAxCreateControl.

AtlAxCreateControlEx

Cria um objeto host, conectá-lo a janela fornecida, então carregá-lo um controle (também permite que os coletores de eventos são configurados).

AtlAxCreateControlLicEx

Cria um controle ActiveX licenciado, inicializa-o, e hospedá-lo na janela especificada, semelhante a AtlAxCreateControlLic.

AtlAxCreateDialog

Cria uma caixa de diálogo sem-modo de um recurso da caixa de diálogo e retorna o identificador de janela.

AtlAxDialogBox

Cria uma caixa de diálogo modal de um recurso da caixa de diálogo.

AtlAxGetControl

Retorna o ponteiro de interface de IUnknown do controle hospedado em uma janela.

AtlAxGetHost

Retorna o ponteiro de interface de IUnknown do objeto host conectado a uma janela.

AtlAxWinInit

Inicializa o código de controle de hospedagem.

AtlAxWinTerm

Uninitializes o código de controle de hospedagem.

Os parâmetros de HWND nas três primeiras funções devem ser uma janela existente de (praticamente) qualquer tipo.Se você chamar qualquer uma de essas três funções explicitamente (normalmente, você não tem que), não passar um identificador para uma janela que já está atuando como um host (se você fizer isso, o objeto existente host não será liberado.)

a primeira ligação de controle sete AtlAxWinInit implicitamente.

ObservaçãoObservação

A API de hospedagem forma a base de suporte de ATL para retenção de controle ActiveX.Em o entanto, há geralmente uma pequena necessidade de chamar diretamente essas funções se você aproveita ou se torna de uso completo de classes envoltório de ATL.Para obter mais informações, consulte ATL classes que facilita a retenção do controle ActiveX?.

Consulte também

Conceitos

Retenção Perguntas Freqüentes de controle de ATL