Condividi tramite


CAxWindow::CreateControl

Crea un controllo ActiveX, la inizializza e lo ospita nella finestra specificata.

HRESULT CreateControl(
   LPCOLESTR lpszName,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL 
);
HRESULT CreateControl(
   DWORD dwResID,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL 
);

Parametri

  • lpszName
    Un puntatore a una stringa per creare il controllo.Deve essere formattato in uno dei modi seguenti:

    • Un ProgID come "MSCAL.Calendar.7"

    • Un CLSID come "{}" 8E27C92B-1264-101C-8A2F-040224009C02

    • Un URL come "https://www.microsoft.com"

    • Un riferimento a un documento attivo in "file://\\Documents\MyDoc.doc"

    • Un frammento di codice HTML come "MSHTML:<HTML><BODY>questo è una riga di text</body></html>"

      [!NOTA]

      "MSHTML: " deve precedere il codice HTML in modo da definirlo di come un flusso di MSHTML.Solo il ProgID e il CLSID sono supportati in piattaforme Windows Mobile.Windows CE ha incorporato le piattaforme, diversa da Windows Mobile con supporto per il supporto di CE e tutti i tipi inclusi ProgID, il CLSID, l'url, il riferimento al documento attivo e il frammento di codice HTML.

  • pStream
    [in] puntatore A un flusso utilizzato per inizializzare le proprietà del controllo.Può essere NULL.

  • ppUnkContainer
    [out] indirizzo di un puntatore che riceverà IUnknown del contenitore.Può essere NULL.

  • dwResID
    ID di risorsa di una risorsa HTML.Il controllo WebBrowser verrà creato e caricato con la risorsa specificata.

Valore restituito

Un valore standard HRESULT.

Note

Se la seconda versione di questo metodo viene utilizzato, un controllo HTML viene creato e associato alla risorsa identificata da dwResID.

Questo metodo fornisce stesso risultato della chiamata:

AtlAxCreateControlEx(lpszName, hWnd, pStream, NULL, NULL, GUID_NULL, NULL);

Vedere CAxWindow2T::CreateControlLic per creare, l'inizializzazione e ospitare un controllo ActiveX con licenza.

Esempio

Vedere Controlli ActiveX di hosting mediante ATL AXHost per un esempio che utilizza CreateControl.

Requisiti

Header: atlwin.h

Vedere anche

Riferimenti

Classe di CAxWindow

AtlAxCreateControl