Classe IOleObjectImpl
Questa classe implementa IUnknown e è l'interfaccia principale tramite cui un contenitore comunica con un controllo .
Importante
Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.
Sintassi
template<class T>
class ATL_NO_VTABLE IOleObjectImpl : public IOleObject
Parametri
T
Classe derivata da IOleObjectImpl.
Membri
Metodi pubblici
| Nome | Descrizione |
|---|---|
| IOleObjectImpl::Advise | Stabilisce una connessione consultiva con il controllo . |
| IOleObjectImpl::Close | Modifica lo stato del controllo dall'esecuzione al caricamento. |
| IOleObjectImpl::D oVerb | Indica al controllo di eseguire una delle azioni enumerate. |
| IOleObjectImpl::D oVerbDiscardUndo | Indica al controllo di rimuovere qualsiasi stato di annullamento gestito. |
| IOleObjectImpl::D oVerbHide | Indica al controllo di rimuovere l'interfaccia utente dalla visualizzazione. |
| IOleObjectImpl::D oVerbInPlaceActivate | Esegue il controllo e ne installa la finestra, ma non installa l'interfaccia utente del controllo. |
| IOleObjectImpl::D oVerbOpen | Determina la modifica del controllo in una finestra separata. |
| IOleObjectImpl::D oVerbPrimary | Esegue l'azione specificata quando l'utente fa doppio clic sul controllo. Il controllo definisce l'azione, in genere per attivare il controllo sul posto. |
| IOleObjectImpl::D oVerbShow | Mostra un controllo appena inserito all'utente. |
| IOleObjectImpl::D oVerbUIActivate | Attiva il controllo sul posto e mostra l'interfaccia utente del controllo, ad esempio menu e barre degli strumenti. |
| IOleObjectImpl::EnumAdvise | Enumera le connessioni di consulenza del controllo. |
| IOleObjectImpl::EnumVerbs | Enumera le azioni per il controllo. |
| IOleObjectImpl::GetClientSite | Recupera il sito client del controllo. |
| IOleObjectImpl::GetClipboardData | Recupera i dati dagli Appunti. L'implementazione ATL restituisce E_NOTIMPL. |
| IOleObjectImpl::GetExtent | Recupera l'extent dell'area di visualizzazione del controllo. |
| IOleObjectImpl::GetMiscStatus | Recupera lo stato del controllo. |
| IOleObjectImpl::GetMoniker | Recupera il moniker del controllo. L'implementazione ATL restituisce E_NOTIMPL. |
| IOleObjectImpl::GetUserClassID | Recupera l'identificatore di classe del controllo. |
| IOleObjectImpl::GetUserType | Recupera il nome del tipo utente del controllo. |
| IOleObjectImpl::InitFromData | Inizializza il controllo dai dati selezionati. L'implementazione ATL restituisce E_NOTIMPL. |
| IOleObjectImpl::IsUpToDate | Controlla se il controllo è aggiornato. L'implementazione ATL restituisce S_OK. |
| IOleObjectImpl::OnPostVerbDiscardUndo | Chiamato da DoVerbDiscardUndo dopo l'eliminazione dello stato di annullamento. |
| IOleObjectImpl::OnPostVerbHide | Chiamato da DoVerbHide dopo che il controllo è nascosto. |
| IOleObjectImpl::OnPostVerbInPlaceActivate | Chiamato da DoVerbInPlaceActivate dopo l'attivazione del controllo. |
| IOleObjectImpl::OnPostVerbOpen | Chiamato da DoVerbOpen dopo che il controllo è stato aperto per la modifica in una finestra separata. |
| IOleObjectImpl::OnPostVerbShow | Chiamato da DoVerbShow dopo che il controllo è stato reso visibile. |
| IOleObjectImpl::OnPostVerbUIActivate | Chiamato da DoVerbUIActivate dopo l'attivazione dell'interfaccia utente del controllo. |
| IOleObjectImpl::OnPreVerbDiscardUndo | Chiamato da DoVerbDiscardUndo prima che lo stato di annullamento venga rimosso. |
| IOleObjectImpl::OnPreVerbHide | Chiamato da DoVerbHide prima che il controllo sia nascosto. |
| IOleObjectImpl::OnPreVerbInPlaceActivate | Chiamato da DoVerbInPlaceActivate prima che il controllo venga attivato sul posto. |
| IOleObjectImpl::OnPreVerbOpen | Chiamato da DoVerbOpen prima che il controllo sia stato aperto per la modifica in una finestra separata. |
| IOleObjectImpl::OnPreVerbShow | Chiamato da DoVerbShow prima che il controllo sia stato reso visibile. |
| IOleObjectImpl::OnPreVerbUIActivate | Chiamato da DoVerbUIActivate prima dell'attivazione dell'interfaccia utente del controllo. |
| IOleObjectImpl::SetClientSite | Indica al controllo il relativo sito client nel contenitore. |
| IOleObjectImpl::SetColorScheme | Consiglia una combinazione di colori per l'applicazione del controllo, se presente. L'implementazione ATL restituisce E_NOTIMPL. |
| IOleObjectImpl::SetExtent | Imposta l'extent dell'area di visualizzazione del controllo. |
| IOleObjectImpl::SetHostNames | Indica al controllo i nomi dell'applicazione contenitore e del documento contenitore. |
| IOleObjectImpl::SetMoniker | Indica al controllo il relativo moniker. L'implementazione ATL restituisce E_NOTIMPL. |
| IOleObjectImpl::Unadvise | Elimina una connessione consultiva con il controllo . |
| IOleObjectImpl::Update | Aggiorna il controllo. L'implementazione ATL restituisce S_OK. |
Osservazioni:
L'interfaccia IOleObject è l'interfaccia principale tramite cui un contenitore comunica con un controllo . La classe IOleObjectImpl fornisce un'implementazione predefinita di questa interfaccia e implementa inviando informazioni al dispositivo di dump nelle compilazioni IUnknown di debug.
Esercitazione su ATL per articoli correlati, creazione di un progetto ATL
Gerarchia di ereditarietà
IOleObject
IOleObjectImpl
Requisiti
Intestazione: atlctl.h
IOleObjectImpl::Advise
Stabilisce una connessione consultiva con il controllo .
STDMETHOD(Advise)(
IAdviseSink* pAdvSink,
DWORD* pdwConnection);
Osservazioni:
Vedi IOleObject::Advise in Windows SDK.
IOleObjectImpl::Close
Modifica lo stato del controllo dall'esecuzione al caricamento.
STDMETHOD(Close)(DWORD dwSaveOption);
Osservazioni:
Disattiva il controllo e elimina definitivamente la finestra di controllo, se esistente. Se il membro dati della classe di controllo CComControlBase::m_bRequiresSave è TRUE e il parametro dwSaveOption è OLECLOSE_SAVEIFDIRTY o OLECLOSE_PROMPTSAVE, le proprietà del controllo vengono salvate prima della chiusura.
I puntatori contenuti nei membri dati della classe di controllo CComControlBase::m_spInPlaceSite e CComControlBase::m_spAdviseSink vengono rilasciati e i membri dei dati CComControlBase::m_bNegotiatedWnd, CComControlBase::m_bWndless e CComControlBase::m_bInPlaceSiteEx sono impostati su FALSE.
Vedi IOleObject::Close in Windows SDK.
IOleObjectImpl::D oVerb
Indica al controllo di eseguire una delle azioni enumerate.
STDMETHOD(DoVerb)(
LONG iVerb,
LPMSG /* pMsg */,
IOleClientSite* pActiveSite,
LONG /* lindex */,
HWND hwndParent,
LPCRECT lprcPosRect);
Osservazioni:
A seconda del valore di iVerb, una delle funzioni helper ATL DoVerb viene chiamata come segue:
| Valore iVerb | Funzione helper DoVerb denominata |
|---|---|
| OLEIVERB_DISCARDUNDOSTATE | DoVerbDiscardUndo |
| OLEIVERB_HIDE | DoVerbHide |
| OLEIVERB_INPLACEACTIVATE | DoVerbInPlaceActivate |
| OLEIVERB_OPEN | DoVerbOpen |
| OLEIVERB_PRIMARY | DoVerbPrimary |
| OLEIVERB_PROPERTIES | CComControlBase::D oVerbProperties |
| OLEIVERB_SHOW | DoVerbShow |
| OLEIVERB_UIACTIVATE | DoVerbUIActivate |
Vedere IOleObject::D oVerb in Windows SDK.
IOleObjectImpl::D oVerbDiscardUndo
Indica al controllo di rimuovere qualsiasi stato di annullamento gestito.
HRESULT DoVerbDiscardUndo(LPCRECT /* prcPosRect */, HWND /* hwndParent */);
Parametri
prcPosRec
[in] Puntatore al rettangolo in cui il contenitore desidera che il controllo disegnare.
hwndParent
[in] Handle della finestra contenente il controllo .
Valore restituito
Restituisce S_OK.
IOleObjectImpl::D oVerbHide
Disattiva e rimuove l'interfaccia utente del controllo e nasconde il controllo.
HRESULT DoVerbHide(LPCRECT /* prcPosRect */, HWND /* hwndParent */);
Parametri
prcPosRec
[in] Puntatore al rettangolo in cui il contenitore desidera che il controllo disegnare.
hwndParent
[in] Handle della finestra contenente il controllo . Non usato nell'implementazione ATL.
Valore restituito
Restituisce S_OK.
IOleObjectImpl::D oVerbInPlaceActivate
Esegue il controllo e ne installa la finestra, ma non installa l'interfaccia utente del controllo.
HRESULT DoVerbInPlaceActivate(LPCRECT prcPosRect, HWND /* hwndParent */);
Parametri
prcPosRec
[in] Puntatore al rettangolo in cui il contenitore desidera che il controllo disegnare.
hwndParent
[in] Handle della finestra contenente il controllo . Non usato nell'implementazione ATL.
Valore restituito
Uno dei valori HRESULT standard.
Osservazioni:
Attiva il controllo sul posto chiamando CComControlBase::InPlaceActivate. A meno che il membro m_bWindowOnly dati della classe di controllo non sia TRUE, DoVerbInPlaceActivate tenta prima di tutto di attivare il controllo come controllo senza finestra (possibile solo se il contenitore supporta IOleInPlaceSiteWindowless). In caso di esito negativo, la funzione tenta di attivare il controllo con funzionalità estese (possibile solo se il contenitore supporta IOleInPlaceSiteEx). In caso di esito negativo, la funzione tenta di attivare il controllo senza funzionalità estese (possibile solo se il contenitore supporta IOleInPlaceSite). Se l'attivazione ha esito positivo, la funzione notifica al contenitore che il controllo è stato attivato.
IOleObjectImpl::D oVerbOpen
Determina la modifica del controllo in una finestra separata.
HRESULT DoVerbOpen(LPCRECT /* prcPosRect */, HWND /* hwndParent */);
Parametri
prcPosRec
[in] Puntatore al rettangolo in cui il contenitore desidera che il controllo disegnare.
hwndParent
[in] Handle della finestra contenente il controllo .
Valore restituito
Restituisce S_OK.
IOleObjectImpl::D oVerbPrimary
Definisce l'azione eseguita quando l'utente fa doppio clic sul controllo.
HRESULT DoVerbPrimary(LPCRECT prcPosRect, HWND hwndParent);
Parametri
prcPosRec
[in] Puntatore al rettangolo in cui il contenitore desidera che il controllo disegnare.
hwndParent
[in] Handle della finestra contenente il controllo .
Valore restituito
Uno dei valori HRESULT standard.
Osservazioni:
Per impostazione predefinita, impostare per visualizzare le pagine delle proprietà. È possibile eseguirne l'override nella classe di controllo per richiamare un comportamento diverso facendo doppio clic; ad esempio, riprodurre un video o passare sul posto attivo.
IOleObjectImpl::D oVerbShow
Indica al contenitore di rendere visibile il controllo.
HRESULT DoVerbShow(LPCRECT prcPosRect, HWND /* hwndParent */);
Parametri
prcPosRec
[in] Puntatore al rettangolo in cui il contenitore desidera che il controllo disegnare.
hwndParent
[in] Handle della finestra contenente il controllo . Non usato nell'implementazione ATL.
Valore restituito
Uno dei valori HRESULT standard.
IOleObjectImpl::D oVerbUIActivate
Attiva l'interfaccia utente del controllo e notifica al contenitore che i relativi menu vengono sostituiti da menu compositi.
HRESULT DoVerbUIActivate(LPCRECT prcPosRect, HWND /* hwndParent */);
Parametri
prcPosRec
[in] Puntatore al rettangolo in cui il contenitore desidera che il controllo disegnare.
hwndParent
[in] Handle della finestra contenente il controllo . Non usato nell'implementazione ATL.
Valore restituito
Uno dei valori HRESULT standard.
IOleObjectImpl::EnumAdvise
Fornisce un'enumerazione delle connessioni di consulenza registrate per questo controllo.
STDMETHOD(EnumAdvise)(IEnumSTATDATA** ppenumAdvise);
Osservazioni:
Vedere IOleObject::EnumAdvise in Windows SDK.
IOleObjectImpl::EnumVerbs
Fornisce un'enumerazione di azioni registrate (verbi) per questo controllo chiamando OleRegEnumVerbs.
STDMETHOD(EnumVerbs)(IEnumOLEVERB** ppEnumOleVerb);
Osservazioni:
È possibile aggiungere verbi al file rgs del progetto. Ad esempio, vedere CIRCCTL. RGS nell'esempio CIRC .
Vedere IOleObject::EnumVerbs in Windows SDK.
IOleObjectImpl::GetClientSite
Inserisce il puntatore nel membro dati della classe di controllo CComControlBase::m_spClientSite in ppClientSite e incrementa il conteggio dei riferimenti sul puntatore.
STDMETHOD(GetClientSite)(IOleClientSite** ppClientSite);
Osservazioni:
Vedere IOleObject::GetClientSite in Windows SDK.
IOleObjectImpl::GetClipboardData
Recupera i dati dagli Appunti.
STDMETHOD(GetClipboardData)(
DWORD /* dwReserved */,
IDataObject** /* ppDataObject */);
Valore restituito
Restituisce E_NOTIMPL.
Osservazioni:
Vedere IOleObject::GetClipboardData in Windows SDK.
IOleObjectImpl::GetExtent
Recupera le dimensioni di visualizzazione di un controllo in esecuzione in unità HIMETRIC (0,01 millimetri per unità).
STDMETHOD(GetExtent)(
DWORD dwDrawAspect,
SIZEL* psizel);
Osservazioni:
Le dimensioni vengono archiviate nel membro dati della classe di controllo CComControlBase::m_sizeExtent.
Vedere IOleObject::GetExtent in Windows SDK.
IOleObjectImpl::GetMiscStatus
Restituisce un puntatore alle informazioni sullo stato registrate per il controllo chiamando OleRegGetMiscStatus.
STDMETHOD(GetMiscStatus)(
DWORD dwAspect,
DWORD* pdwStatus);
Osservazioni:
Le informazioni sullo stato includono comportamenti supportati dai dati di controllo e presentazione. È possibile aggiungere informazioni sullo stato al file rgs del progetto.
Vedere IOleObject::GetMiscStatus in Windows SDK.
IOleObjectImpl::GetMoniker
Recupera il moniker del controllo.
STDMETHOD(GetMoniker)(
DWORD /* dwAssign */,
DWORD /* dwWhichMoniker */,
IMoniker** /* ppmk */);
Valore restituito
Restituisce E_NOTIMPL.
Osservazioni:
Vedere IOleObject::GetMoniker in Windows SDK.
IOleObjectImpl::GetUserClassID
Restituisce l'identificatore di classe del controllo.
STDMETHOD(GetUserClassID)(CLSID* pClsid);
Osservazioni:
Vedere IOleObject::GetUserClassID in Windows SDK.
IOleObjectImpl::GetUserType
Restituisce il nome del tipo utente del controllo chiamando OleRegGetUserType.
STDMETHOD(GetUserType)(
DWORD dwFormOfType,
LPOLESTR* pszUserType);
Osservazioni:
Il nome di tipo utente viene usato per la visualizzazione in elementi dell'interfaccia utente, ad esempio menu e finestre di dialogo. È possibile modificare il nome del tipo utente nel file con estensione rgs del progetto.
Vedere IOleObject::GetUserType in Windows SDK.
IOleObjectImpl::InitFromData
Inizializza il controllo dai dati selezionati.
STDMETHOD(InitFromData)(
IDataObject* /* pDataObject */,
BOOL /* fCreation */,
DWORD /* dwReserved */);
Valore restituito
Restituisce E_NOTIMPL.
Osservazioni:
Vedere IOleObject::InitFromData in Windows SDK.
IOleObjectImpl::IsUpToDate
Controlla se il controllo è aggiornato.
STDMETHOD(IsUpToDate)(void);
Valore restituito
Restituisce S_OK.
Osservazioni:
Vedere IOleObject::IsUpToDate in Windows SDK.
IOleObjectImpl::OnPostVerbDiscardUndo
Chiamato da DoVerbDiscardUndo dopo l'eliminazione dello stato di annullamento.
HRESULT OnPostVerbDiscardUndo();
Valore restituito
Restituisce S_OK.
Osservazioni:
Eseguire l'override di questo metodo con il codice che si desidera eseguire dopo l'eliminazione dello stato di annullamento.
IOleObjectImpl::OnPostVerbHide
Chiamato da DoVerbHide dopo che il controllo è nascosto.
HRESULT OnPostVerbHide();
Valore restituito
Restituisce S_OK.
Osservazioni:
Eseguire l'override di questo metodo con il codice che si desidera eseguire dopo che il controllo è nascosto.
IOleObjectImpl::OnPostVerbInPlaceActivate
Chiamato da DoVerbInPlaceActivate dopo l'attivazione del controllo.
HRESULT OnPostVerbInPlaceActivate();
Valore restituito
Restituisce S_OK.
Osservazioni:
Eseguire l'override di questo metodo con il codice che si desidera eseguire dopo l'attivazione del controllo sul posto.
IOleObjectImpl::OnPostVerbOpen
Chiamato da DoVerbOpen dopo che il controllo è stato aperto per la modifica in una finestra separata.
HRESULT OnPostVerbOpen();
Valore restituito
Restituisce S_OK.
Osservazioni:
Eseguire l'override di questo metodo con il codice che si desidera eseguire dopo l'apertura del controllo per la modifica in una finestra separata.
IOleObjectImpl::OnPostVerbShow
Chiamato da DoVerbShow dopo che il controllo è stato reso visibile.
HRESULT OnPostVerbShow();
Valore restituito
Restituisce S_OK.
Osservazioni:
Eseguire l'override di questo metodo con il codice che si desidera eseguire dopo che il controllo è stato reso visibile.
IOleObjectImpl::OnPostVerbUIActivate
Chiamato da DoVerbUIActivate dopo l'attivazione dell'interfaccia utente del controllo.
HRESULT OnPostVerbUIActivate();
Valore restituito
Restituisce S_OK.
Osservazioni:
Eseguire l'override di questo metodo con il codice che si desidera eseguire dopo l'attivazione dell'interfaccia utente del controllo.
IOleObjectImpl::OnPreVerbDiscardUndo
Chiamato da DoVerbDiscardUndo prima che lo stato di annullamento venga rimosso.
HRESULT OnPreVerbDiscardUndo();
Valore restituito
Restituisce S_OK.
Osservazioni:
Per evitare che lo stato di annullamento venga rimosso, eseguire l'override di questo metodo per restituire un errore HRESULT.
IOleObjectImpl::OnPreVerbHide
Chiamato da DoVerbHide prima che il controllo sia nascosto.
HRESULT OnPreVerbHide();
Valore restituito
Restituisce S_OK.
Osservazioni:
Per impedire che il controllo venga nascosto, eseguire l'override di questo metodo per restituire un errore HRESULT.
IOleObjectImpl::OnPreVerbInPlaceActivate
Chiamato da DoVerbInPlaceActivate prima che il controllo venga attivato sul posto.
HRESULT OnPreVerbInPlaceActivate();
Valore restituito
Restituisce S_OK.
Osservazioni:
Per impedire che il controllo venga attivato sul posto, eseguire l'override di questo metodo per restituire un errore HRESULT.
IOleObjectImpl::OnPreVerbOpen
Chiamato da DoVerbOpen prima che il controllo sia stato aperto per la modifica in una finestra separata.
HRESULT OnPreVerbOpen();
Valore restituito
Restituisce S_OK.
Osservazioni:
Per impedire l'apertura del controllo per la modifica in una finestra separata, eseguire l'override di questo metodo per restituire un errore HRESULT.
IOleObjectImpl::OnPreVerbShow
Chiamato da DoVerbShow prima che il controllo sia stato reso visibile.
HRESULT OnPreVerbShow();
Valore restituito
Restituisce S_OK.
Osservazioni:
Per impedire che il controllo venga reso visibile, eseguire l'override di questo metodo per restituire un errore HRESULT.
IOleObjectImpl::OnPreVerbUIActivate
Chiamato da DoVerbUIActivate prima dell'attivazione dell'interfaccia utente del controllo.
HRESULT OnPreVerbUIActivate();
Valore restituito
Restituisce S_OK.
Osservazioni:
Per impedire l'attivazione dell'interfaccia utente del controllo, eseguire l'override di questo metodo per restituire un errore HRESULT.
IOleObjectImpl::SetClientSite
Indica al controllo il relativo sito client nel contenitore.
STDMETHOD(SetClientSite)(IOleClientSite* pClientSite);
Osservazioni:
Il metodo restituisce quindi S_OK.
Vedere IOleObject::SetClientSite in Windows SDK.
IOleObjectImpl::SetColorScheme
Consiglia una combinazione di colori per l'applicazione del controllo, se presente.
STDMETHOD(SetColorScheme)(LOGPALETTE* /* pLogPal */);
Valore restituito
Restituisce E_NOTIMPL.
Osservazioni:
Vedere IOleObject::SetColorScheme in Windows SDK.
IOleObjectImpl::SetExtent
Imposta l'extent dell'area di visualizzazione del controllo.
STDMETHOD(SetExtent)(
DWORD dwDrawAspect,
SIZEL* psizel);
Osservazioni:
In caso contrario, SetExtent archivia il valore a cui psizel punta nel membro dati della classe del controllo CComControlBase::m_sizeExtent. Questo valore è espresso in unità HIMETRIC (0,01 millimetri per unità).
Se il membro dati della classe di controllo CComControlBase::m_bResizeNatural è TRUE, SetExtent archivia anche il valore a psizel cui punta nel membro dati della classe di controllo CComControlBase::m_sizeNatural.
Se il membro dati della classe di controllo CComControlBase::m_bRecomposeOnResize è TRUE, SetExtent chiama SendOnDataChange e SendOnViewChange notifica a tutti i sink consultivi registrati con il titolare del consiglio che la dimensione del controllo è cambiata.
Vedere IOleObject::SetExtent in Windows SDK.
IOleObjectImpl::SetHostNames
Indica al controllo i nomi dell'applicazione contenitore e del documento contenitore.
STDMETHOD(SetHostNames)(LPCOLESTR /* szContainerApp */, LPCOLESTR /* szContainerObj */);
Valore restituito
Restituisce S_OK.
Osservazioni:
Vedere IOleObject::SetHostNames in Windows SDK.
IOleObjectImpl::SetMoniker
Indica al controllo il relativo moniker.
STDMETHOD(SetMoniker)(
DWORD /* dwWhichMoniker */,
IMoniker** /* pmk */);
Valore restituito
Restituisce E_NOTIMPL.
Osservazioni:
Vedere IOleObject::SetMoniker in Windows SDK.
IOleObjectImpl::Unadvise
Elimina la connessione consultiva archiviata nel membro dati della classe del m_spOleAdviseHolder controllo.
STDMETHOD(Unadvise)(DWORD dwConnection);
Osservazioni:
Vedere IOleObject::Unadvise in Windows SDK.
IOleObjectImpl::Update
Aggiorna il controllo.
STDMETHOD(Update)(void);
Valore restituito
Restituisce S_OK.
Osservazioni:
Vedere IOleObject::Update in Windows SDK.
Vedi anche
Classe CComControl
Interfacce dei controlli ActiveX
Cenni preliminari sulla classe