Classe di COleClientItem

Articolo
02/19/2013

Definisce l'interfaccia del contenitore agli elementi OLE.

class COleClientItem : public CDocItem

Membri

Costruttori pubblici

Nome	Descrizione
COleClientItem::COleClientItem	Costruisce un oggetto COleClientItem.

Metodi pubblici

Nome	Descrizione
COleClientItem::Activate	Aprire l'elemento OLE per un'operazione quindi esegue il verbo specificato.
COleClientItem::ActivateAs	Attiva l'elemento come altro tipo.
COleClientItem::AttachDataObject	L'accesso ai dati nell'oggetto OLE.
COleClientItem::CanCreateFromData	Indica se un'applicazione contenitore può creare un oggetto incorporato.
COleClientItem::CanCreateLinkFromData	Indica se un'applicazione contenitore può creare un oggetto collegato.
COleClientItem::CanPaste	Indica se gli Appunti contengono un elemento OLE integrabile o statico.
COleClientItem::CanPasteLink	Indica se gli Appunti contengono un elemento collegabile OLE.
COleClientItem::Close	Chiude un collegamento a un server ma non elimina l'elemento OLE.
COleClientItem::ConvertTo	Converte l'elemento a un altro.
COleClientItem::CopyToClipboard	Copiare l'elemento OLE negli Appunti.
COleClientItem::CreateCloneFrom	Viene creato un duplicato di un elemento esistente.
COleClientItem::CreateFromClipboard	Crea un elemento incorporato dagli Appunti.
COleClientItem::CreateFromData	Crea un elemento incorporato da un oggetto dati.
COleClientItem::CreateFromFile	Crea un elemento incorporato da un file.
COleClientItem::CreateLinkFromClipboard	Crea un elemento collegato dagli Appunti.
COleClientItem::CreateLinkFromData	Crea un elemento collegato da un oggetto dati.
COleClientItem::CreateLinkFromFile	Crea un elemento collegato da un file.
COleClientItem::CreateNewItem	Crea un nuovo elemento incorporato avviando l'applicazione server.
COleClientItem::CreateStaticFromClipboard	Crea un elemento statico dagli Appunti.
COleClientItem::CreateStaticFromData	Crea un elemento statico da un oggetto dati.
COleClientItem::Deactivate	Disattiva l'elemento.
COleClientItem::DeactivateUI	Ripristino dell'interfaccia utente dell'applicazione contenitore allo stato originale.
COleClientItem::Delete	Elimina o chiudere l'elemento OLE se fosse un elemento collegato.
COleClientItem::DoDragDrop	Esegue un'operazione di trascinamento.
COleClientItem::DoVerb	Esegue il verbo specificato.
COleClientItem::Draw	Estrae l'elemento OLE.
COleClientItem::GetActiveView	Ottiene la visualizzazione dell'elemento viene attivato sul posto.
COleClientItem::GetCachedExtent	Restituisce i limiti del rettangolo dell'elemento OLE.
COleClientItem::GetClassID	Ottiene l'id della classe dell'elemento corrente
COleClientItem::GetClipboardData	Ottiene i dati che verranno inseriti negli Appunti chiamando la funzione membro CopyToClipboard.
COleClientItem::GetDocument	Restituisce l'oggetto COleDocument contenente l'elemento corrente.
COleClientItem::GetDrawAspect	Ottiene la visualizzazione dell'elemento corrente per il rendering.
COleClientItem::GetExtent	Restituisce i limiti del rettangolo dell'elemento OLE.
COleClientItem::GetIconFromRegistry	Retrives handle a un'icona associata al server di un CLSID particolare.
COleClientItem::GetIconicMetafile	Ottiene un metafile utilizzate per creare l'icona dell'elemento.
COleClientItem::GetInPlaceWindow	Restituisce un puntatore alla finestra di modifica sul posto dell'elemento.
COleClientItem::GetItemState	Ottiene lo stato corrente dell'elemento.
COleClientItem::GetLastStatus	Restituisce lo stato dell'ultima operazione OLE.
COleClientItem::GetLinkUpdateOptions	Restituisce la modalità di aggiornamento per un elemento collegato (funzionalità avanzate).
COleClientItem::GetType	Restituisce il tipo (incorporato, collegato, o statici) dell'elemento OLE.
COleClientItem::GetUserType	Ottiene una stringa che descrive il tipo di elemento.
COleClientItem::IsInPlaceActive	Restituisce TRUE se l'elemento è attivo sul posto.
COleClientItem::IsLinkUpToDate	Restituisce TRUE se un elemento collegato verrà aggiornato con il documento di origine.
COleClientItem::IsModified	Restituisce TRUE se l'elemento è stato modificato da quando è stato salvato per ultima.
COleClientItem::IsOpen	Restituisce TRUE se l'elemento è attualmente aperto nell'applicazione server.
COleClientItem::IsRunning	Restituisce TRUE se l'applicazione server dell'elemento è in esecuzione.
COleClientItem::OnActivate	Chiamato dal framework per notificare all'elemento che viene attivato.
COleClientItem::OnActivateUI	Chiamato dal framework per notificare all'elemento che viene attivato e deve mostrare la relativa interfaccia utente.
COleClientItem::OnChange	Chiamato quando il server modifica l'elemento OLE.Implementazione richiesta.
COleClientItem::OnDeactivate	Chiamato dal framework quando un elemento viene disabilitato.
COleClientItem::OnDeactivateUI	Chiamato dal framework quando il server ha rimosso la relativa interfaccia utente sul posto.
COleClientItem::OnGetClipboardData	Chiamato dal framework per ottenere i dati per essere copiato negli Appunti.
COleClientItem::OnInsertMenus	Chiamato dal framework per creare un menu composto.
COleClientItem::OnRemoveMenus	Chiamato dal framework per rimuovere i menu del contenitore da un menu composto.
COleClientItem::OnSetMenu	Chiamato dal framework per impostare e rimuovere un menu composto.
COleClientItem::OnShowControlBars	Chiamato dal framework per visualizzare e nascondere le barre di controllo.
COleClientItem::OnUpdateFrameTitle	Chiamato dal framework per aggiornare la didascalia della finestra cornice.
COleClientItem::ReactivateAndUndo	Riattivare l'elemento e annullata l'ultima operazione di modifica sul posto.
COleClientItem::Release	Elimina la connessione a un elemento collegato OLE e la chiusura se è stata aperta.Non elimina l'elemento client.
COleClientItem::Reload	Ricarica l'elemento dopo una chiamata a ActivateAs.
COleClientItem::Run	Esegue l'applicazione associata all'elemento.
COleClientItem::SetDrawAspect	Imposta la visualizzazione dell'elemento corrente per il rendering.
COleClientItem::SetExtent	Imposta il rettangolo di delimitazione dell'elemento OLE.
COleClientItem::SetHostNames	Imposta i nomi che il server viene visualizzato quando modifica l'elemento OLE.
COleClientItem::SetIconicMetafile	Memorizza nella cache metafile utilizzate per creare l'icona dell'elemento.
COleClientItem::SetItemRects	Imposta il rettangolo di delimitazione dell'elemento.
COleClientItem::SetLinkUpdateOptions	Imposta la modalità di aggiornamento per un elemento collegato (funzionalità avanzate).
COleClientItem::SetPrintDevice	Imposta il dispositivo di stampa di destinazione per l'elemento client.
COleClientItem::UpdateLink	Aggiorna la cache di presentazione di un elemento.

Metodi protetti

Nome	Descrizione
COleClientItem::CanActivate	Chiamato dal framework per determinare se l'attivazione sul posto è consentita.
COleClientItem::OnChangeItemPosition	Chiamato dal framework quando si modifica la posizione di un elemento.
COleClientItem::OnDeactivateAndUndo	Chiamato dal framework per annullare dopo l'attivazione.
COleClientItem::OnDiscardUndoState	Chiamato dal framework per rimuovere le informazioni sullo stato di annullamento dell'elemento.
COleClientItem::OnGetClipRect	Chiamato dal framework per ottenere coordinate del rettangolo di ridimensionamento dell'elemento.
COleClientItem::OnGetItemPosition	Chiamato dal framework per ottenere la posizione dell'elemento nella visualizzazione.
COleClientItem::OnGetWindowContext	Chiamato dal framework quando un elemento viene attivato sul posto.
COleClientItem::OnScrollBy	Chiamato dal framework per lo scorrimento nella visualizzazione.
COleClientItem::OnShowItem	Chiamato dal framework per visualizzare l'elemento OLE.

Note

Un elemento OLE rappresenta i dati, creati e gestiti da un'applicazione server, che può "senza problemi" essere inclusa in un documento in modo che venga visualizzato all'utente essere un singolo documento.Il risultato è "un documento composto" composto l'elemento OLE e di un documento contenente.

Un elemento OLE può essere incorporato o collegato.Se è incorporato, i dati sono archiviati come parte del documento composto.Se sono collegati, i dati sono archiviati come parte di un file separato creati dall'applicazione server e solo un collegamento al file viene archiviato nel documento composto.Tutti gli elementi OLE contiene informazioni che specificano l'applicazione server che deve essere chiamata per modificarli.

COleClientItem definisce diverse funzioni sottoponibili a override che vengono chiamate in risposta a richieste dall'applicazione server; questi overridables generalmente agiscono da notifiche.In questo modo l'applicazione server al contenitore delle modifiche apportate dall'utente quando viene modificato l'elemento OLE, o recuperare le informazioni necessarie durante la modifica.

COleClientItem può essere utilizzato con la classe COleDocument, COleLinkingDoc, o COleServerDoc.Per utilizzare COleClientItem, derivare una classe da e implementare la funzione membro OnChange, che definisce come il contenitore risposta alle modifiche apportate all'elemento.Per supportare l'attivazione sul posto, eseguire l'override della funzione membro OnGetItemPosition.Questa funzione vengono fornite informazioni sul percorso visualizzato dell'elemento OLE.

Per ulteriori informazioni sull'interfaccia del contenitore, vedere gli articoli contenitori: implementare un contenitore e attivazione.

[!NOTA]

Windows SDK fa riferimento a incorporato e gli elementi collegati oggetti "e" fa riferimento ai tipi di elementi come "classe". Questo utilizzo di riferimento il termine "elemento" distinguere l'entità OLE dall'oggetto corrispondente C++ e il termine "tipo" per distinguere la categoria OLE dalla classe C++.