Classe CComControlBase

Articolo
08/03/2024

Questa classe fornisce metodi per la creazione e la gestione di controlli ATL.

Importante

Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.

Sintassi

class ATL_NO_VTABLE CComControlBase

Membri

Typedef pubblici

Nome	Descrizione
CComControlBase::AppearanceType	Eseguire l'override se la `m_nAppearance` proprietà stock non è di tipo `short`.

Costruttori pubblici

Nome	Descrizione
CComControlBase::CComControlBase	Costruttore.
CComControlBase::~CComControlBase	Distruttore.

Metodi pubblici

Nome	Descrizione
CComControlBase::ControlQueryInterface	Recupera un puntatore all'interfaccia richiesta.
CComControlBase::D oesVerbActivate	Verifica che il parametro iVerb utilizzato da `IOleObjectImpl::DoVerb` attiva l'interfaccia utente del controllo (iVerb è uguale a OLEIVERB_UIACTIVATE), definisce l'azione eseguita quando l'utente fa doppio clic sul controllo (iVerb è uguale a OLEIVERB_PRIMARY), visualizza il controllo (iVerb è uguale a OLEIVERB_SHOW) o attiva il controllo (iVerb è uguale a OLEIVERB_INPLACEACTIVATE).
CComControlBase::D oesVerbUIActivate	Verifica che il parametro iVerb usato da `IOleObjectImpl::DoVerb` causi l'attivazione dell'interfaccia utente del controllo e restituisca TRUE.
CComControlBase::D oVerbProperties	Visualizza le pagine delle proprietà del controllo.
CComControlBase::FireViewChange	Chiamare questo metodo per indicare al contenitore di ridisegnare il controllo o notificare ai sink registrati che la visualizzazione del controllo è stata modificata.
CComControlBase::GetAmbientAppearance	Recupera DISPID_AMBIENT_APPEARANCE, l'impostazione dell'aspetto corrente per il controllo: 0 per flat e 1 per 3D.
CComControlBase::GetAmbientAutoClip	Recupera DISPID_AMBIENT_AUTOCLIP, un flag che indica se il contenitore supporta il ritaglio automatico dell'area di visualizzazione del controllo.
CComControlBase::GetAmbientBackColor	Recupera DISPID_AMBIENT_BACKCOLOR, il colore di sfondo ambientale per tutti i controlli, definiti dal contenitore.
CComControlBase::GetAmbientCharSet	Recupera DISPID_AMBIENT_CHARSET, il set di caratteri di ambiente per tutti i controlli, definito dal contenitore.
CComControlBase::GetAmbientCodePage	Recupera DISPID_AMBIENT_CODEPAGE, il set di caratteri di ambiente per tutti i controlli, definito dal contenitore.
CComControlBase::GetAmbientDisplayAsDefault	Recupera DISPID_AMBIENT_DISPLAYASDEFAULT, un flag TRUE se il contenitore ha contrassegnato il controllo in questo sito come pulsante predefinito e pertanto un controllo pulsante deve disegnare se stesso con una cornice più spessa.
CComControlBase::GetAmbientDisplayName	Recupera DISPID_AMBIENT_DISPLAYNAME, il nome fornito dal contenitore al controllo.
CComControlBase::GetAmbientFont	Recupera un puntatore all'interfaccia di ambiente `IFont` del contenitore.
CComControlBase::GetAmbientFontDisp	Recupera un puntatore all'interfaccia di invio ambientale `IFontDisp` del contenitore.
CComControlBase::GetAmbientForeColor	Recupera DISPID_AMBIENT_FORECOLOR, il colore di primo piano di ambiente per tutti i controlli, definiti dal contenitore.
CComControlBase::GetAmbientLocaleID	Recupera DISPID_AMBIENT_LOCALEID, l'identificatore della lingua usata dal contenitore.
CComControlBase::GetAmbientMessageReflect	Recupera DISPID_AMBIENT_MESSAGEREFLECT, un flag che indica se il contenitore desidera ricevere messaggi di finestra,ad esempio WM_DRAWITEM, come eventi.
CComControlBase::GetAmbientPalette	Recupera DISPID_AMBIENT_PALETTE, usato per accedere all'HPALETTE del contenitore.
CComControlBase::GetAmbientProperty	Recupera la proprietà del contenitore specificata dall'ID.
CComControlBase::GetAmbientRightToLeft	Recupera DISPID_AMBIENT_RIGHTTOLEFT, la direzione in cui il contenuto viene visualizzato dal contenitore.
CComControlBase::GetAmbientScaleUnits	Recupera DISPID_AMBIENT_SCALEUNITS, le unità di ambiente del contenitore (ad esempio pollici o centimetri) per la visualizzazione delle etichette.
CComControlBase::GetAmbientShowGrabHandles	Recupera DISPID_AMBIENT_SHOWGRABHANDLES, un flag che indica se il contenitore consente al controllo di visualizzare handle di afferramento per se stesso quando è attivo.
CComControlBase::GetAmbientShowHatching	Recupera DISPID_AMBIENT_SHOWHATCHING, un flag che indica se il contenitore consente al controllo di visualizzare se stesso con un modello tratteggio quando l'interfaccia utente è attiva.
CComControlBase::GetAmbientSupportsMnemonics	Recupera DISPID_AMBIENT_SUPPORTSMNEMONICS, un flag che indica se il contenitore supporta la tastiera mnemonics.
CComControlBase::GetAmbientTextAlign	Recupera DISPID_AMBIENT_TEXTALIGN, l'allineamento del testo preferito dal contenitore: 0 per l'allineamento generale (numeri a destra, testo a sinistra), 1 per l'allineamento sinistro, 2 per l'allineamento al centro e 3 per l'allineamento a destra.
CComControlBase::GetAmbientTopToBottom	Recupera DISPID_AMBIENT_TOPTOBOTTOM, la direzione in cui il contenuto viene visualizzato dal contenitore.
CComControlBase::GetAmbientUIDead	Recupera DISPID_AMBIENT_UIDEAD, un flag che indica se il contenitore desidera che il controllo risponda alle azioni dell'interfaccia utente.
CComControlBase::GetAmbientUserMode	Recupera DISPID_AMBIENT_USERMODE, un flag che indica se il contenitore è in modalità di esecuzione (TRUE) o in modalità progettazione (FALSE).
CComControlBase::GetDirty	Restituisce il valore del membro `m_bRequiresSave`dati .
CComControlBase::GetZoomInfo	Recupera i valori x e y del numeratore e del denominatore del fattore di zoom per un controllo attivato per la modifica sul posto.
CComControlBase::InPlaceActivate	Fa sì che il controllo passi dallo stato inattivo a qualsiasi stato indicato dal verbo in iVerb .
CComControlBase::InternalGetSite	Chiamare questo metodo per eseguire una query sul sito di controllo per un puntatore all'interfaccia identificata.
CComControlBase::OnDraw	Eseguire l'override di questo metodo per disegnare il controllo.
CComControlBase::OnDrawAdvanced	L'impostazione predefinita `OnDrawAdvanced` prepara un contesto di dispositivo normalizzato per il disegno, quindi chiama il metodo della classe di `OnDraw` controllo.
CComControlBase::OnKillFocus	Verifica che il controllo sia attivo sul posto e abbia un sito di controllo valido, quindi informa il contenitore che il controllo ha perso lo stato attivo.
CComControlBase::OnMouseActivate	Verifica che l'interfaccia utente sia in modalità utente, quindi attiva il controllo.
CComControlBase::OnPaint	Prepara il contenitore per disegnare, ottiene l'area client del controllo, quindi chiama il metodo della classe di `OnDraw` controllo.
CComControlBase::OnSetFocus	Verifica che il controllo sia attivo sul posto e abbia un sito di controllo valido, quindi informa il contenitore che il controllo ha ottenuto lo stato attivo.
CComControlBase::P reTranslateAccelerator	Eseguire l'override di questo metodo per fornire gestori dell'acceleratore di tastiera personalizzati.
CComControlBase::SendOnClose	Notifica a tutti i sink consultivi registrati con il titolare del consiglio che il controllo è stato chiuso.
CComControlBase::SendOnDataChange	Notifica a tutti i sink consultivi registrati con il titolare del consiglio che i dati di controllo sono stati modificati.
CComControlBase::SendOnRename	Notifica a tutti i sink consultivi registrati con il titolare del consiglio che il controllo ha un nuovo moniker.
CComControlBase::SendOnSave	Notifica a tutti i sink consultivi registrati con il titolare del consiglio che il controllo è stato salvato.
CComControlBase::SendOnViewChange	Notifica a tutti i sink di avviso registrati che la visualizzazione del controllo è cambiata.
CComControlBase::SetControlFocus	Imposta o rimuove lo stato attivo della tastiera da o verso il controllo .
CComControlBase::SetDirty	Imposta il membro `m_bRequiresSave` dati sul valore in bDirty.

Membri dati pubblici

Nome	Descrizione
CComControlBase::m_bAutoSize	Flag che indica che il controllo non può essere di altre dimensioni.
CComControlBase::m_bDrawFromNatural	Flag che indica che `IDataObjectImpl::GetData` e `CComControlBase::GetZoomInfo` devono impostare le dimensioni del controllo da `m_sizeNatural` anziché da `m_sizeExtent`.
CComControlBase::m_bDrawGetDataInHimetric	Flag che indica che `IDataObjectImpl::GetData` deve utilizzare unità HIMETRIC e non pixel durante il disegno.
CComControlBase::m_bInPlaceActive	Flag che indica che il controllo è attivo sul posto.
CComControlBase::m_bInPlaceSiteEx	Flag che indica che il contenitore supporta le funzionalità di `IOleInPlaceSiteEx` controllo INTERFACE e OCX96, ad esempio controlli senza finestra e senza sfarfallio.
CComControlBase::m_bNegotiatedWnd	Flag che indica se il controllo ha negoziato con il contenitore il supporto per le funzionalità di controllo RTF96 (ad esempio controlli senza sfarfallio e senza finestra) e se il controllo è finestrato o senza finestra.
CComControlBase::m_bRecomposeOnResize	Flag che indica che il controllo vuole ricomporre la presentazione quando il contenitore modifica le dimensioni di visualizzazione del controllo.
CComControlBase::m_bRequiresSave	Flag che indica che il controllo è stato modificato dopo l'ultimo salvataggio.
CComControlBase::m_bResizeNatural	Flag che indica che il controllo vuole ridimensionare l'extent naturale (dimensioni fisiche non ridimensionate) quando il contenitore modifica le dimensioni di visualizzazione del controllo.
CComControlBase::m_bUIActive	Flag che indica l'interfaccia utente del controllo, ad esempio menu e barre degli strumenti, è attiva.
CComControlBase::m_bUsingWindowRgn	Flag che indica che il controllo usa l'area della finestra fornita dal contenitore.
CComControlBase::m_bWasOnceWindowless	Flag che indica che il controllo è stato senza finestra, ma può essere o meno senza finestra ora.
CComControlBase::m_bWindowOnly	Flag che indica che il controllo deve essere finestrato, anche se il contenitore supporta controlli senza finestra.
CComControlBase::m_bWndLess	Flag che indica che il controllo è senza finestra.
CComControlBase::m_hWndCD	Contiene un riferimento all'handle di finestra associato al controllo .
CComControlBase::m_nFreezeEvents	Un conteggio del numero di volte in cui il contenitore ha bloccato gli eventi (rifiutati di accettare eventi) senza un'intersezione di eventi (accettazione degli eventi).
CComControlBase::m_rcPos	Posizione in pixel del controllo, espressa nelle coordinate del contenitore.
CComControlBase::m_sizeExtent	L'estensione del controllo in unità HIMETRIC (ogni unità è di 0,01 millimetri) per un particolare display.
CComControlBase::m_sizeNatural	Dimensioni fisiche del controllo in unità HIMETRIC (ogni unità è 0,01 millimetri).
CComControlBase::m_spAdviseSink	Puntatore diretto alla connessione consultiva nel contenitore (IAdviseSink del contenitore).
CComControlBase::m_spAmbientDispatch	Oggetto `CComDispatchDriver` che consente di recuperare e impostare le proprietà del contenitore tramite un `IDispatch` puntatore.
CComControlBase::m_spClientSite	Puntatore al sito client del controllo all'interno del contenitore.
CComControlBase::m_spDataAdviseHolder	Fornisce uno standard per contenere connessioni consultive tra gli oggetti dati e consigliare i sink.
CComControlBase::m_spInPlaceSite	Puntatore al puntatore dell'interfaccia IOleInPlaceSite, IOleInPlaceSiteEx o IOleInPlaceSiteWindowless del contenitore.
CComControlBase::m_spOleAdviseHolder	Fornisce un'implementazione standard di un modo per contenere le connessioni consultive.

Osservazioni:

Questa classe fornisce metodi per la creazione e la gestione di controlli ATL. La classe CComControl deriva da CComControlBase. Quando si crea un controllo Standard o DHTML tramite la Creazione guidata controllo ATL, la procedura guidata deriva automaticamente la classe da CComControlBase.

Per altre informazioni sulla creazione di un controllo, vedere l'esercitazione su ATL. Per altre informazioni sulla Creazione guidata progetto ATL, vedere l'articolo Creazione di un progetto ATL.

Requisiti

Intestazione: atlctl.h

CComControlBase::AppearanceType

Eseguire l'override se la m_nAppearance proprietà stock non è di tipo short.

typedef short AppearanceType;

Osservazioni:

La Creazione guidata controllo ATL aggiunge m_nAppearance la proprietà stock di tipo short. Eseguire l'override AppearanceType se si usa un tipo di dati diverso.

CComControlBase::CComControlBase

Costruttore.

CComControlBase(HWND& h);

Parametri

h
Handle della finestra associata al controllo .

Osservazioni:

Inizializza le dimensioni del controllo su 5080X5080 unità HIMETRIC (2"X2") e inizializza i CComControlBase valori dei membri dati su NULL o FALSE.

CComControlBase::~CComControlBase

Distruttore.

~CComControlBase();

Osservazioni:

Se il controllo viene finestrato, ~CComControlBase lo elimina chiamando DestroyWindow.

CComControlBase::ControlQueryInterface

Recupera un puntatore all'interfaccia richiesta.

virtual HRESULT ControlQueryInterface(const IID& iid,
    void** ppv);

Parametri

iid
GUID dell'interfaccia richiesta.

ppv
Puntatore al puntatore dell'interfaccia identificato da iid o NULL se l'interfaccia non viene trovata.

Osservazioni:

Gestisce solo le interfacce nella tabella mappa COM.

Esempio

// Retrieve the control's IOleObject interface. Note interface 
// is automatically released when pOleObject goes out of scope

CComPtr<IOleObject> pOleObject;
ControlQueryInterface(IID_IOleObject, (void**)&pOleObject);

CComControlBase::D oesVerbActivate

Verifica che il parametro iVerb utilizzato da IOleObjectImpl::DoVerb attiva l'interfaccia utente del controllo (iVerb è uguale a OLEIVERB_UIACTIVATE), definisce l'azione eseguita quando l'utente fa doppio clic sul controllo (iVerb è uguale a OLEIVERB_PRIMARY), visualizza il controllo (iVerb è uguale a OLEIVERB_SHOW) o attiva il controllo (iVerb è uguale a OLEIVERB_INPLACEACTIVATE).

BOOL DoesVerbActivate(LONG iVerb);

Parametri

iVerb
Valore che indica l'azione da eseguire da DoVerb.

Valore restituito

Restituisce TRUE se iVerb è uguale a OLEIVERB_UIACTIVATE, OLEIVERB_PRIMARY, OLEIVERB_SHOW o OLEIVERB_INPLACEACTIVATE; in caso contrario, restituisce FALSE.

Osservazioni:

È possibile eseguire l'override di questo metodo per definire il verbo di attivazione.

CComControlBase::D oesVerbUIActivate

Verifica che il parametro iVerb usato da IOleObjectImpl::DoVerb causi l'attivazione dell'interfaccia utente del controllo e restituisca TRUE.

BOOL DoesVerbUIActivate(LONG iVerb);

Parametri

iVerb
Valore che indica l'azione da eseguire da DoVerb.

Valore restituito

Restituisce TRUE se iVerb è uguale a OLEIVERB_UIACTIVATE, OLEIVERB_PRIMARY, OLEIVERB_SHOW o OLEIVERB_INPLACEACTIVATE. In caso contrario, il metodo restituisce FALSE.

CComControlBase::D oVerbProperties

Visualizza le pagine delle proprietà del controllo.

HRESULT DoVerbProperties(LPCRECT /* prcPosRect */, HWND hwndParent);

Parametri

prcPosRec
Riservato.

hwndParent
Handle della finestra contenente il controllo .

Valore restituito

Uno dei valori HRESULT standard.

Esempio

// The following implementation of the WM_RBUTTONDOWN message handler
// will pop up the ActiveX Control's PropertyPages 
LRESULT CMyComposite::OnRButtonDown(UINT /*uMsg*/, WPARAM /*wParam*/, 
   LPARAM /*lParam*/, BOOL& /*bHandled*/)
{
   DoVerbProperties(NULL, ::GetActiveWindow());
   return 0L;
}

MESSAGE_HANDLER(WM_RBUTTONDOWN, OnRButtonDown)

CComControlBase::FireViewChange

Chiamare questo metodo per indicare al contenitore di ridisegnare il controllo o notificare ai sink registrati che la visualizzazione del controllo è stata modificata.

HRESULT FireViewChange();

Valore restituito

Uno dei valori HRESULT standard.

Osservazioni:

Se il controllo è attivo (il membro dati della classe di controllo CComControlBase::m_bInPlaceActive è TRUE), notifica al contenitore che si desidera ridisegnare l'intero controllo. Se il controllo è inattivo, notifica ai sink registrati del controllo (tramite il membro dati della classe di controllo CComControlBase::m_spAdviseSink) che la visualizzazione del controllo è stata modificata.

Esempio

STDMETHODIMP CMyControl::put_Shape(int newVal)
{
   // store newVal in m_nShape user-defined member
   m_nShape = newVal;

   // notify container to redraw control
   FireViewChange();
   return S_OK;
}

CComControlBase::GetAmbientAppearance

Recupera DISPID_AMBIENT_APPEARANCE, l'impostazione dell'aspetto corrente per il controllo: 0 per flat e 1 per 3D.

HRESULT GetAmbientAppearance(short& nAppearance);

Parametri

nAppearance
Proprietà DISPID_AMBIENT_APPEARANCE.

Valore restituito

Uno dei valori HRESULT standard.

Esempio

HRESULT OnDraw(ATL_DRAWINFO& di)
{
   short nAppearance;
   RECT& rc = *(RECT*)di.prcBounds;

   // draw 3D border if AmbientAppearance is not supported or is set to 1 
   HRESULT hr = GetAmbientAppearance(nAppearance);
   if (hr != S_OK || nAppearance==1)
   {
      DrawEdge(di.hdcDraw, &rc, EDGE_SUNKEN, BF_RECT);
   }
   else
   {
      Rectangle(di.hdcDraw, rc.left, rc.top, rc.right, rc.bottom);
   }

   SetTextAlign(di.hdcDraw, TA_CENTER|TA_BASELINE);
   LPCTSTR pszText = _T("ATL 8.0 : MyControl");

   // For security reasons, we recommend that you use the lstrlen function
   // with caution. Here, we can guarantee that pszText is NULL terminated,
   // and therefore it is safe to use this function.
   TextOut(di.hdcDraw, 
      (rc.left + rc.right) / 2, 
      (rc.top + rc.bottom) / 2, 
      pszText, 
      lstrlen(pszText));

   return S_OK;
}

CComControlBase::GetAmbientAutoClip

Recupera DISPID_AMBIENT_AUTOCLIP, un flag che indica se il contenitore supporta il ritaglio automatico dell'area di visualizzazione del controllo.

HRESULT GetAmbientAutoClip(BOOL& bAutoClip);

Parametri

bAutoClip
Proprietà DISPID_AMBIENT_AUTOCLIP.

Valore restituito

Uno dei valori HRESULT standard.

CComControlBase::GetAmbientBackColor

Recupera DISPID_AMBIENT_BACKCOLOR, il colore di sfondo ambientale per tutti i controlli, definiti dal contenitore.

HRESULT GetAmbientBackColor(OLE_COLOR& BackColor);

Parametri

BackColor
Proprietà DISPID_AMBIENT_BACKCOLOR.

Valore restituito

Uno dei valori HRESULT standard.

CComControlBase::GetAmbientCharSet

Recupera DISPID_AMBIENT_CHARSET, il set di caratteri di ambiente per tutti i controlli, definito dal contenitore.

HRESULT GetAmbientCharSet(BSTR& bstrCharSet);

Parametri

bstrCharSet
Proprietà DISPID_AMBIENT_CHARSET.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

CComControlBase::GetAmbientCodePage

Recupera DISPID_AMBIENT_CODEPAGE, la tabella codici di ambiente per tutti i controlli, definita dal contenitore.

HRESULT GetAmbientCodePage(ULONG& ulCodePage);

Parametri

ulCodePage
Proprietà DISPID_AMBIENT_CODEPAGE.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

CComControlBase::GetAmbientDisplayAsDefault

Recupera DISPID_AMBIENT_DISPLAYASDEFAULT, un flag TRUE se il contenitore ha contrassegnato il controllo in questo sito come pulsante predefinito e pertanto un controllo pulsante deve disegnare se stesso con una cornice più spessa.

HRESULT GetAmbientDisplayAsDefault(BOOL& bDisplayAsDefault);

Parametri

bDisplayAsDefault
Proprietà DISPID_AMBIENT_DISPLAYASDEFAULT.

Valore restituito

Uno dei valori HRESULT standard.

CComControlBase::GetAmbientDisplayName

Recupera DISPID_AMBIENT_DISPLAYNAME, il nome fornito dal contenitore al controllo.

HRESULT GetAmbientDisplayName(BSTR& bstrDisplayName);

Parametri

bstrDisplayName
Proprietà DISPID_AMBIENT_DISPLAYNAME.

Valore restituito

Uno dei valori HRESULT standard.

CComControlBase::GetAmbientFont

Recupera un puntatore all'interfaccia di ambiente IFont del contenitore.

HRESULT GetAmbientFont(IFont** ppFont);

Parametri

ppFont
Puntatore all'interfaccia IFont ambientale del contenitore.

Valore restituito

Uno dei valori HRESULT standard.

Osservazioni:

Se la proprietà è NULL, il puntatore è NULL. Se il puntatore non è NULL, il chiamante deve rilasciare il puntatore.

CComControlBase::GetAmbientFontDisp

Recupera un puntatore all'interfaccia di invio ambientale IFontDisp del contenitore.

HRESULT GetAmbientFontDisp(IFontDisp** ppFont);

Parametri

CComControlBase::GetAmbientMessageReflect

Recupera DISPID_AMBIENT_MESSAGEREFLECT, un flag che indica se il contenitore desidera ricevere messaggi della finestra ( ad esempio WM_DRAWITEM) come eventi.

HRESULT GetAmbientMessageReflect(BOOL& bMessageReflect);

Parametri

bMessageReflect
Proprietà DISPID_AMBIENT_MESSAGEREFLECT.

Valore restituito

Uno dei valori HRESULT standard.

CComControlBase::GetAmbientPalette

Recupera DISPID_AMBIENT_PALETTE, usato per accedere all'HPALETTE del contenitore.

HRESULT GetAmbientPalette(HPALETTE& hPalette);

Parametri

hPalette
Proprietà DISPID_AMBIENT_PALETTE.

Valore restituito

Uno dei valori HRESULT standard.

CComControlBase::GetAmbientProperty

Recupera la proprietà contenitore specificata da dispid.

HRESULT GetAmbientProperty(DISPID dispid, VARIANT& var);

Osservazioni:

Se TRUE, il controllo non deve rispondere. Questo flag si applica indipendentemente dal flag DISPID_AMBIENT_USERMODE. Vedere CComControlBase::GetAmbientUserMode.

CComControlBase::GetAmbientUserMode

Recupera DISPID_AMBIENT_USERMODE, un flag che indica se il contenitore è in modalità di esecuzione (TRUE) o in modalità progettazione (FALSE).

HRESULT GetAmbientUserMode(BOOL& bUserMode);

Parametri

bUserMode
Proprietà DISPID_AMBIENT_USERMODE.

Valore restituito

Uno dei valori HRESULT standard.

CComControlBase::GetDirty

Restituisce il valore del membro m_bRequiresSavedati .

BOOL GetDirty();

Valore restituito

Restituisce il valore del membro dati m_bRequiresSave.

Osservazioni:

Questo valore viene impostato usando CComControlBase::SetDirty.

CComControlBase::GetZoomInfo

Recupera i valori x e y del numeratore e del denominatore del fattore di zoom per un controllo attivato per la modifica sul posto.

void GetZoomInfo(ATL_DRAWINFO& di);

Parametri

di
Struttura che conterrà il numeratore e il denominatore del fattore di zoom. Per altre informazioni, vedere ATL_DRAWINFO.

Osservazioni:

Il fattore di zoom è la proporzione delle dimensioni naturali del controllo fino all'estensione corrente.

CComControlBase::InPlaceActivate

Fa sì che il controllo passi dallo stato inattivo a qualsiasi stato indicato dal verbo in iVerb .

HRESULT InPlaceActivate(LONG iVerb, const RECT* prcPosRect = NULL);

Parametri

iVerb
Valore che indica l'azione da eseguire da IOleObjectImpl::D oVerb.

prcPosRect
Puntatore alla posizione del controllo sul posto.

Valore restituito

Uno dei valori HRESULT standard.

Osservazioni:

Prima dell'attivazione, questo metodo verifica che il controllo disponga di un sito client, controlla la quantità di controllo visibile e ottiene la posizione del controllo nella finestra padre. Dopo l'attivazione del controllo, questo metodo attiva l'interfaccia utente del controllo e indica al contenitore di rendere visibile il controllo.

Questo metodo recupera anche un IOleInPlaceSitepuntatore di interfaccia , IOleInPlaceSiteExo IOleInPlaceSiteWindowless per il controllo e lo archivia nel membro dati della classe di controllo CComControlBase::m_spInPlaceSite. I membri dati della classe di controllo CComControlBase::m_bInPlaceSiteEx, CComControlBase::m_bWndLess, CComControlBase::m_bWasOnceWindowless e CComControlBase::m_bNegotiatedWnd sono impostati su true in base alle esigenze.

CComControlBase::InternalGetSite

Chiamare questo metodo per eseguire una query sul sito di controllo per un puntatore all'interfaccia identificata.

HRESULT InternalGetSite(REFIID riid, void** ppUnkSite);

Parametri

riid
IID del puntatore all'interfaccia che deve essere restituito in ppUnkSite.

ppUnkSite
Indirizzo della variabile del puntatore che riceve il puntatore dell'interfaccia richiesto in riid.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Se il sito supporta l'interfaccia richiesta in riid, il puntatore viene restituito tramite ppUnkSite. In caso contrario, ppUnkSite è impostato su NULL.

CComControlBase::m_bAutoSize

Flag che indica che il controllo non può essere di altre dimensioni.

unsigned m_bAutoSize:1;

Osservazioni:

Questo flag viene controllato da IOleObjectImpl::SetExtent e, se TRUE, fa sì che la funzione restituisca E_FAIL.

Nota

Per usare questo membro dati all'interno della classe di controllo, è necessario dichiararlo come membro dati nella classe del controllo. La classe di controllo non erediterà questo membro dati dalla classe di base perché viene dichiarato all'interno di un'unione nella classe base.

Se si aggiunge l'opzione Dimensioni automatiche nella scheda Proprietà predefinite della Creazione guidata controllo ATL, la procedura guidata crea automaticamente questo membro dati nella classe di controllo, crea metodi put e get per la proprietà e supporta IPropertyNotifySink per notificare automaticamente al contenitore quando la proprietà viene modificata.

CComControlBase::m_bDrawFromNatural

Flag che indica che IDataObjectImpl::GetData e CComControlBase::GetZoomInfo devono impostare le dimensioni del controllo da m_sizeNatural anziché da m_sizeExtent.

unsigned m_bDrawFromNatural:1;

Osservazioni:

Nota

CComControlBase::m_bDrawGetDataInHimetric

Flag che indica che IDataObjectImpl::GetData deve utilizzare unità HIMETRIC e non pixel durante il disegno.

unsigned m_bDrawGetDataInHimetric:1;

Osservazioni:

Ogni unità HIMETRIC logica è 0,01 millimetri.

Nota

CComControlBase::m_bInPlaceActive

Flag che indica che il controllo è attivo sul posto.

unsigned m_bInPlaceActive:1;

Osservazioni:

Ciò significa che il controllo è visibile e la relativa finestra, se presente, è visibile, ma i relativi menu e barre degli strumenti potrebbero non essere attivi. Il m_bUIActive flag indica che l'interfaccia utente del controllo, ad esempio i menu, è attiva.

Nota

CComControlBase::m_bInPlaceSiteEx

Flag che indica che il contenitore supporta le funzionalità di IOleInPlaceSiteEx controllo INTERFACE e OCX96, ad esempio controlli senza finestra e senza sfarfallio.

unsigned m_bInPlaceSiteEx:1;

Osservazioni:

Nota

Il membro m_spInPlaceSite dati punta a un'interfaccia IOleInPlaceSite, IOleInPlaceSiteEx o IOleInPlaceSiteWindowless , a seconda del valore dei m_bWndLess flag e m_bInPlaceSiteEx . Il membro m_bNegotiatedWnd dati deve essere TRUE affinché il m_spInPlaceSite puntatore sia valido.

Se m_bWndLess è FALSE ed m_bInPlaceSiteEx è TRUE, m_spInPlaceSite è un puntatore all'interfaccia IOleInPlaceSiteEx . Vedere m_spInPlaceSite per una tabella che mostra la relazione tra questi tre membri dati.

CComControlBase::m_bNegotiatedWnd

Flag che indica se il controllo ha negoziato con il contenitore il supporto per le funzionalità di controllo RTF96 (ad esempio controlli senza sfarfallio e senza finestra) e se il controllo è finestrato o senza finestra.

unsigned m_bNegotiatedWnd:1;

Osservazioni:

Nota

Il m_bNegotiatedWnd flag deve essere TRUE affinché il m_spInPlaceSite puntatore sia valido.

CComControlBase::m_bRecomposeOnResize

Flag che indica che il controllo vuole ricomporre la presentazione quando il contenitore modifica le dimensioni di visualizzazione del controllo.

unsigned m_bRecomposeOnResize:1;

Osservazioni:

Nota

Questo flag viene controllato da IOleObjectImpl::SetExtent e, se TRUE, SetExtent invia una notifica al contenitore delle modifiche della visualizzazione. se questo flag è impostato, deve essere impostato anche il bit OLEMISC_RECOMPOSEONRESIZE nell'enumerazione OLEMISC .

CComControlBase::m_bRequiresSave

Flag che indica che il controllo è stato modificato dopo l'ultimo salvataggio.

unsigned m_bRequiresSave:1;

Osservazioni:

Il valore di m_bRequiresSave può essere impostato con CComControlBase::SetDirty e recuperato con CComControlBase::GetDirty.

Nota

CComControlBase::m_bResizeNatural

Flag che indica che il controllo vuole ridimensionare l'extent naturale (dimensioni fisiche non ridimensionate) quando il contenitore modifica le dimensioni di visualizzazione del controllo.

unsigned m_bResizeNatural:1;

Osservazioni:

Questo flag viene controllato da IOleObjectImpl::SetExtent e, se TRUE, le dimensioni passate a SetExtent vengono assegnate a m_sizeNatural.

Le dimensioni passate a SetExtent vengono sempre assegnate a m_sizeExtent, indipendentemente dal valore di m_bResizeNatural.

Nota

CComControlBase::m_bUIActive

Flag che indica l'interfaccia utente del controllo, ad esempio menu e barre degli strumenti, è attiva.

unsigned m_bUIActive:1;

Osservazioni:

Il m_bInPlaceActive flag indica che il controllo è attivo, ma non che l'interfaccia utente è attiva.

Nota

CComControlBase::m_bUsingWindowRgn

Flag che indica che il controllo usa l'area della finestra fornita dal contenitore.

unsigned m_bUsingWindowRgn:1;

Osservazioni:

Nota

CComControlBase::m_bWasOnceWindowless

Flag che indica che il controllo è stato senza finestra, ma può essere o meno senza finestra ora.

unsigned m_bWasOnceWindowless:1;

Osservazioni:

Nota

CComControlBase::m_bWindowOnly

Flag che indica che il controllo deve essere finestrato, anche se il contenitore supporta controlli senza finestra.

unsigned m_bWindowOnly:1;

Osservazioni:

Nota

CComControlBase::m_bWndLess

Flag che indica che il controllo è senza finestra.

unsigned m_bWndLess:1;

Osservazioni:

Nota

Il membro m_spInPlaceSite dati punta a un'interfaccia IOleInPlaceSite, IOleInPlaceSiteEx o IOleInPlaceSiteWindowless , a seconda del valore dei m_bWndLess flag e CComControlBase::m_bInPlaceSiteEx . (Membro datiCComControlBase::m_bNegotiatedWnd deve essere TRUE affinché il puntatore CComControlBase::m_spInPlaceSite sia valido.

Se m_bWndLess è TRUE, m_spInPlaceSite è un puntatore all'interfaccia IOleInPlaceSiteWindowless . Per una tabella che mostra la relazione completa tra questi membri dati, vedere CComControlBase::m_spInPlaceSite .

CComControlBase::m_hWndCD

Contiene un riferimento all'handle di finestra associato al controllo .

HWND& m_hWndCD;

Osservazioni:

Nota

CComControlBase::m_nFreezeEvents

Un conteggio del numero di volte in cui il contenitore ha bloccato gli eventi (rifiutati di accettare eventi) senza un'intersezione di eventi (accettazione degli eventi).

short m_nFreezeEvents;

Osservazioni:

Nota

CComControlBase::m_rcPos

Posizione in pixel del controllo, espressa nelle coordinate del contenitore.

RECT m_rcPos;

Osservazioni:

Nota

CComControlBase::m_sizeExtent

L'estensione del controllo in unità HIMETRIC (ogni unità è di 0,01 millimetri) per un particolare display.

SIZE m_sizeExtent;

Osservazioni:

Nota

Questa dimensione viene ridimensionata in base allo schermo. Le dimensioni fisiche del controllo sono specificate nel m_sizeNatural membro dati e sono fisse.

È possibile convertire le dimensioni in pixel con la funzione globale AtlHiMetricToPixel.

CComControlBase::m_sizeNatural

Dimensioni fisiche del controllo in unità HIMETRIC (ogni unità è 0,01 millimetri).

SIZE m_sizeNatural;

Osservazioni:

Nota

Questa dimensione è fissa, mentre la dimensione in m_sizeExtent è ridimensionata dal display.

È possibile convertire le dimensioni in pixel con la funzione globale AtlHiMetricToPixel.

CComControlBase::m_spAdviseSink

Puntatore diretto alla connessione consultiva nel contenitore (IAdviseSink del contenitore).

CComPtr<IAdviseSink>
    m_spAdviseSink;

Osservazioni:

Nota

CComControlBase::m_spAmbientDispatch

Oggetto CComDispatchDriver che consente di recuperare e impostare le proprietà di un oggetto tramite un IDispatch puntatore.

CComDispatchDriver m_spAmbientDispatch;

Osservazioni:

Nota

CComControlBase::m_spClientSite

Puntatore al sito client del controllo all'interno del contenitore.

CComPtr<IOleClientSite>
    m_spClientSite;

Osservazioni:

Nota

CComControlBase::m_spDataAdviseHolder

Fornisce uno standard per contenere connessioni consultive tra gli oggetti dati e consigliare i sink.

CComPtr<IDataAdviseHolder>
    m_spDataAdviseHolder;

Osservazioni:

Nota

Un oggetto dati è un controllo in grado di trasferire dati e che implementa IDataObject, i cui metodi specificano il formato e il supporto di trasferimento dei dati.

L'interfaccia m_spDataAdviseHolder implementa i metodi IDataObject::D Advise e IDataObject::D Unadvise per stabilire ed eliminare connessioni consultive al contenitore. Il contenitore del controllo deve implementare un sink di avviso supportando l'interfaccia IAdviseSink .

CComControlBase::m_spInPlaceSite

Puntatore al puntatore dell'interfaccia IOleInPlaceSite, IOleInPlaceSiteEx o IOleInPlaceSiteWindowless del contenitore.

CComPtr<IOleInPlaceSiteWindowless>
    m_spInPlaceSite;

Osservazioni:

Nota

Il m_spInPlaceSite puntatore è valido solo se il flag m_bNegotiatedWnd è TRUE.

Nella tabella seguente viene illustrato come il m_spInPlaceSite tipo di puntatore dipende dai flag m_bWndLess e m_bInPlaceSiteEx membro dati:

tipo m_spInPlaceSite	valore m_bWndLess	valore m_bInPlaceSiteEx
`IOleInPlaceSiteWindowless`	TRUE	TRUE o FALSE
`IOleInPlaceSiteEx`	FALSE	TRUE
`IOleInPlaceSite`	FALSE	FALSE

CComControlBase::m_spOleAdviseHolder

Fornisce un'implementazione standard di un modo per contenere le connessioni consultive.

CComPtr<IOleAdviseHolder>
    m_spOleAdviseHolder;

Osservazioni:

Nota

L'interfaccia m_spOleAdviseHolder implementa i metodi IOleObject::Advise e IOleObject::Unadvise per stabilire ed eliminare connessioni consultive al contenitore. Il contenitore del controllo deve implementare un sink di avviso supportando l'interfaccia IAdviseSink .

CComControlBase::OnDraw

Eseguire l'override di questo metodo per disegnare il controllo.

virtual HRESULT OnDraw(ATL_DRAWINFO& di);

Parametri

di
Riferimento alla struttura ATL_DRAWINFO che contiene informazioni di disegno, ad esempio l'aspetto di disegno, i limiti del controllo e se il disegno è ottimizzato o meno.

Valore restituito

Valore HRESULT standard.

Osservazioni:

Il valore predefinito OnDraw elimina o ripristina il contesto del dispositivo o non esegue alcuna operazione, a seconda dei flag impostati in CComControlBase::OnDrawAdvanced.

Un OnDraw metodo viene aggiunto automaticamente alla classe di controllo quando si crea il controllo con la Creazione guidata controllo ATL. L'impostazione predefinita OnDraw della procedura guidata disegna un rettangolo con l'etichetta "ATL 8.0".

Esempio

Vedere l'esempio per CComControlBase::GetAmbientAppearance.

CComControlBase::OnDrawAdvanced

L'impostazione predefinita OnDrawAdvanced prepara un contesto di dispositivo normalizzato per il disegno, quindi chiama il metodo della classe di OnDraw controllo.

virtual HRESULT OnDrawAdvanced(ATL_DRAWINFO& di);

Parametri

di
Riferimento alla struttura ATL_DRAWINFO che contiene informazioni di disegno, ad esempio l'aspetto di disegno, i limiti del controllo e se il disegno è ottimizzato o meno.

Valore restituito

Valore HRESULT standard.

Osservazioni:

Eseguire l'override di questo metodo se si vuole accettare il contesto di dispositivo passato dal contenitore senza normalizzarlo.

Per altri dettagli, vedere CComControlBase::OnDraw .

CComControlBase::OnKillFocus

Verifica che il controllo sia attivo sul posto e abbia un sito di controllo valido, quindi informa il contenitore che il controllo ha perso lo stato attivo.

LRESULT OnKillFocus(UINT /* nMsg */,
    WPARAM /* wParam */,
    LPARAM /* lParam */,
    BOOL& bHandled);

Parametri

nMsg
Riservato.

wParam
Riservato.

lParam
Riservato.

bHandled
Flag che indica se il messaggio della finestra è stato gestito correttamente. Il valore predefinito è FALSE.

Valore restituito

Restituisce sempre 1.

CComControlBase::OnMouseActivate

Verifica che l'interfaccia utente sia in modalità utente, quindi attiva il controllo.

LRESULT OnMouseActivate(UINT /* nMsg */,
    WPARAM /* wParam */,
    LPARAM /* lParam */,
    BOOL& bHandled);

Parametri

nMsg
Riservato.

wParam
Riservato.

lParam
Riservato.

bHandled
Flag che indica se il messaggio della finestra è stato gestito correttamente. Il valore predefinito è FALSE.

Valore restituito

Restituisce sempre 1.

CComControlBase::OnPaint

Prepara il contenitore per disegnare, ottiene l'area client del controllo, quindi chiama il metodo della classe di OnDrawAdvanced controllo.

LRESULT OnPaint(UINT /* nMsg */,
    WPARAM wParam,
    LPARAM /* lParam */,
    BOOL& /* lResult */);

Parametri

nMsg
Riservato.

wParam
HdC esistente.

lParam
Riservato.

lResult
Riservato.

Valore restituito

Restituisce sempre zero.

Osservazioni:

Se wParam non è NULL, OnPaint presuppone che contenga un HDC valido e lo usi invece di CComControlBase::m_hWndCD.

CComControlBase::OnSetFocus

Verifica che il controllo sia attivo sul posto e abbia un sito di controllo valido, quindi informa il contenitore che il controllo ha ottenuto lo stato attivo.

LRESULT OnSetFocus(UINT /* nMsg */,
    WPARAM /* wParam */,
    LPARAM /* lParam */,
    BOOL& bHandled);

Parametri

nMsg
Riservato.

wParam
Riservato.

lParam
Riservato.

bHandled
Flag che indica se il messaggio della finestra è stato gestito correttamente. Il valore predefinito è FALSE.

Valore restituito

Restituisce sempre 1.

Osservazioni:

Invia una notifica al contenitore in cui il controllo ha ricevuto lo stato attivo.

CComControlBase::P reTranslateAccelerator

Eseguire l'override di questo metodo per fornire gestori dell'acceleratore di tastiera personalizzati.

BOOL PreTranslateAccelerator(LPMSG /* pMsg */,
    HRESULT& /* hRet */);

Parametri

pMsg
Riservato.

hRet
Riservato.

Valore restituito

Per impostazione predefinita, restituisce FALSE.

CComControlBase::SendOnClose

Notifica a tutti i sink consultivi registrati con il titolare del consiglio che il controllo è stato chiuso.

HRESULT SendOnClose();

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Invia una notifica che indica che il controllo ha chiuso i sink di avviso.

CComControlBase::SendOnDataChange

Notifica a tutti i sink consultivi registrati con il titolare del consiglio che i dati di controllo sono stati modificati.

HRESULT SendOnDataChange(DWORD advf = 0);

Parametri

advf
Consigliare i flag che specificano come viene eseguita la chiamata a IAdviseSink::OnDataChange . I valori provengono dall'enumerazione ADVF .

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

CComControlBase::SendOnRename

Notifica a tutti i sink consultivi registrati con il titolare del consiglio che il controllo ha un nuovo moniker.

HRESULT SendOnRename(IMoniker* pmk);

Parametri

Pmk
Puntatore al nuovo moniker del controllo.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Invia una notifica che indica che il moniker per il controllo è stato modificato.

CComControlBase::SendOnSave

Notifica a tutti i sink consultivi registrati con il titolare del consiglio che il controllo è stato salvato.

HRESULT SendOnSave();

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

Invia una notifica che indica che il controllo ha appena salvato i dati.

CComControlBase::SendOnViewChange

Notifica a tutti i sink di avviso registrati che la visualizzazione del controllo è cambiata.

HRESULT SendOnViewChange(DWORD dwAspect, LONG lindex = -1);

Parametri

dwAspect
Aspetto o visualizzazione del controllo.

lindex
Parte della visualizzazione modificata. Solo -1 è valido.

Valore restituito

Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.

Osservazioni:

SendOnViewChange chiama IAdviseSink::OnViewChange. L'unico valore di lindex attualmente supportato è -1, che indica che l'intera visualizzazione è di interesse.

CComControlBase::SetControlFocus

Imposta o rimuove lo stato attivo della tastiera da o verso il controllo .

BOOL SetControlFocus(BOOL bGrab);

Parametri

bGrab
Se TRUE, imposta lo stato attivo della tastiera sul controllo chiamante. Se FALSE, rimuove lo stato attivo della tastiera dal controllo chiamante, purché abbia lo stato attivo.

Valore restituito

Restituisce TRUE se il controllo riceve correttamente lo stato attivo; in caso contrario, FALSE.

Osservazioni:

Per un controllo finestra, viene chiamata la funzione Dell'API Windows SetFocus . Per un controllo senza finestra, viene chiamato IOleInPlaceSiteWindowless::SetFocus . Tramite questa chiamata, un controllo senza finestra ottiene lo stato attivo della tastiera e può rispondere ai messaggi della finestra.

CComControlBase::SetDirty

Imposta il membro m_bRequiresSave dati sul valore in bDirty.

void SetDirty(BOOL bDirty);

Parametri

bDirty
Valore del membro dati CComControlBase::m_bRequiresSave.

Osservazioni:

SetDirty(TRUE) deve essere chiamato per contrassegnare che il controllo è stato modificato dopo l'ultimo salvataggio. Il valore di m_bRequiresSave viene recuperato con CComControlBase::GetDirty.

Vedi anche

Classe CComControl
Cenni preliminari sulla classe

Condividi tramite

Classe CComControlBase

Sintassi

Membri

Typedef pubblici

Costruttori pubblici

Metodi pubblici

Membri dati pubblici

Osservazioni:

Requisiti

CComControlBase::AppearanceType

Osservazioni:

CComControlBase::CComControlBase

Parametri

Osservazioni:

CComControlBase::~CComControlBase

Osservazioni:

CComControlBase::ControlQueryInterface

Parametri

Osservazioni:

Esempio

CComControlBase::D oesVerbActivate

Parametri

Valore restituito

Osservazioni:

CComControlBase::D oesVerbUIActivate

Parametri

Valore restituito

CComControlBase::D oVerbProperties

Parametri

Valore restituito

Esempio

CComControlBase::FireViewChange

Valore restituito

Osservazioni:

Esempio

CComControlBase::GetAmbientAppearance

Parametri

Valore restituito

Esempio

CComControlBase::GetAmbientAutoClip

Parametri

Valore restituito

CComControlBase::GetAmbientBackColor

Parametri

Valore restituito

CComControlBase::GetAmbientCharSet

Parametri

Valore restituito

CComControlBase::GetAmbientCodePage

Parametri

Valore restituito

CComControlBase::GetAmbientDisplayAsDefault

Parametri

Valore restituito

CComControlBase::GetAmbientDisplayName

Parametri

Valore restituito

CComControlBase::GetAmbientFont

Parametri

Valore restituito

Osservazioni:

CComControlBase::GetAmbientFontDisp

Parametri

Valore restituito

Osservazioni:

CComControlBase::GetAmbientForeColor

Parametri

Valore restituito

CComControlBase::GetAmbientLocaleID

Parametri

Valore restituito

Osservazioni:

CComControlBase::GetAmbientMessageReflect

Parametri

Valore restituito

CComControlBase::GetAmbientPalette

Parametri

Valore restituito

CComControlBase::GetAmbientProperty