COleControlContainer::CreateControl

Articolo
06/10/2015

Crea un controllo ActiveX, ospitato dall'oggetto specificato 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  
);

Parametri

pWndCtrl
Un puntatore all'oggetto finestra che rappresenta il controllo.
clsid
ID univoco della classe del controllo.
lpszWindowName
Un puntatore al testo da visualizzare nel controllo. Imposta il valore della barra del titolo o della proprietà Text del controllo (se presente). Se NULL, la barra del titolo del controllo o la proprietà Text non viene modificato.
dwStyle
Stili di Windows. Gli stili disponibili sono elencati nella sezione Note.
rect
Specifica la dimensione e la posizione del controllo. Può essere un oggetto CRect o una struttura RECT.
nID
Specifica l'id della finestra figlio del controllo
pPersist
Un puntatore a CFile che contiene lo stato persistente per il controllo. Il valore predefinito è NULL, per indicare che il controllo viene inizializzato senza ripristinare lo stato da qualsiasi archivio permanente. Se non NULL, deve essere un puntatore a CFileoggetto derivato da che contiene dati persistenti del controllo, sotto forma di flusso o di archiviazione. Questi dati possono essere salvati di attivazione precedente del client. CFile può contenere altri dati, ma deve l'impostazione puntatore di lettura e scrittura al primo byte di dati persistenti al momento della chiamata a CreateControl.
bStorage
Indica se i dati in pPersist devono essere interpretati come IStorage o dati IStream. Se i dati in pPersist sono un'archiviazione, bStorage deve essere TRUE. Se i dati in pPersist sono un flusso, bStorage deve essere FALSE. Il valore predefinito è FALSE.
bstrLicKey
Dati facoltativi il codice di licenza. Di questi dati sono necessarie solo per creare controlli che richiedono una chiave di licenza runtime. Se il controllo supporta la licenza, è necessario specificare un codice di licenza per la creazione del controllo per gestire. Il valore predefinito è NULL.
ppNewSite
Un puntatore al sito di controllo esistente che ospiterà il controllo creato. Il valore predefinito è NULL, per indicare che un nuovo sito del controllo verrà automaticamente creato e aggiunto al nuovo controllo.
ppt
Un puntatore a una struttura di punti che contiene l'angolo superiore sinistro del controllo. La dimensione del controllo è determinata dal valore psize. ppt e psize valori è un metodo facoltativo di specificare la dimensione e posizione del controllo.
psize
Un puntatore a una struttura SIZE che contiene la dimensione del controllo. L'angolo superiore sinistro è determinato dal valore ppt. ppt e psize valori è un metodo facoltativo di specificare la dimensione e posizione del controllo.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Note

Solo un sottoinsieme dei flag di Windows dwStyle è supportato da CreateControl:

WS_VISIBLE crea una finestra che inizialmente è visibile. Obbligatorio se si desidera che il controllo sia visibile immediatamente, come le normali finestre.
WS_DISABLED crea una finestra che inizialmente è disabilitata. Una finestra disattivata non può ricevere l'input dall'utente. È possibile impostare se il controllo ha una proprietà attivata.
WS_BORDER crea una finestra con un bordo di sottile- riga. È possibile impostare se il controllo ha una proprietà di BorderStyle.
WS_GROUP specifica il primo controllo di un gruppo di controlli. L'utente può modificare lo stato attivo da un controllo nel gruppo a l utilizzando i tasti di direzione. Tutti i controlli definiti con lo stile WS_GROUP dopo il primo controllo appartengono allo stesso gruppo. Il controllo successivo alla fine dello stile WS_GROUP il gruppo e avvia il gruppo successivo.
WS_TABSTOP specifica di un controllo che può ricevere lo stato attivo quando l'utente preme il tasto TAB. Premere le modifiche di tasto TAB lo stato attivo al controllo successivo dello stile WS_TABSTOP.

Utilizzare il secondo overload per creare controlli predefinito della.

Requisiti

Header: afxocc.h

Vedere anche

Riferimenti

Classe COleControlContainer

Grafico delle gerarchie

Condividi tramite