Qual è il controllo API di Hosting ATL?

Il controllo API di hosting ATL è il set di funzioni che consente a qualsiasi finestra fungono da contenitore di controlli ActiveX.Queste funzioni consentono il collegamento statico o dinamico nel progetto poiché sono disponibili come codice sorgente ed esposto da ATL90.dll.Le funzioni di controlli host sono elencate nella tabella riportata di seguito.

Funzione

Descrizione

AtlAxAttachControl

Crea un oggetto host, lo connette alla finestra fornita, si associa un controllo esistente.

AtlAxCreateControl

Crea un oggetto host, lo connette alla finestra fornita, quindi carica un controllo.

AtlAxCreateControlLic

Crea un controllo ActiveX con licenza, la inizializza e lo ospita nella finestra specificata, simile a AtlAxCreateControl.

AtlAxCreateControlEx

Crea un oggetto host, lo connette alla finestra fornita, quindi carica un controllo (consente inoltre ai sink di evento da installare).

AtlAxCreateControlLicEx

Crea un controllo ActiveX con licenza, la inizializza e lo ospita nella finestra specificata, simile a AtlAxCreateControlLic.

AtlAxCreateDialog

Crea una finestra di dialogo non modale da una risorsa finestra di dialogo e restituisce l'handle della finestra.

AtlAxDialogBox

Crea una finestra di dialogo modale da una risorsa finestra di dialogo.

AtlAxGetControl

Restituisce un puntatore a interfaccia IUnknown del controllo ospitato in una finestra.

AtlAxGetHost

Restituisce un puntatore a interfaccia IUnknown dell'oggetto host connesso a una finestra.

AtlAxWinInit

Inizializza il codice del controllo ospitato.

AtlAxWinTerm

Uninitializes il codice del controllo ospitato.

I parametri HWND nelle prime tre funzioni devono essere una finestra esistente (quasi) di qualsiasi tipo.Se si chiama uno di questi tre funzioni in modo esplicito (in genere, non è necessario), non passare l'handle della finestra già viene utilizzato come host (in questo caso, l'oggetto host esistente non sarà liberato).

La prima chiamata di sette funzioni AtlAxWinInit in modo implicito.

[!NOTA]

Il controllo API di hosting costituisce la base del supporto ATL a contenimento del controllo ActiveX.Tuttavia, esiste in genere un occorre chiamare direttamente le funzioni se si avvale di o utilizzare appieno le classi wrapper ATL.Per ulteriori informazioni, vedere Quale le classi ATL facilita il contenimento del controllo ActiveX?.

Vedere anche

Concetti

Il contenimento dei controlli domande frequenti su ATL