COleClientItem-Klasse

Artikel
06/10/2015

Definiert die Containerschnittstelle zu den OLE-Elementen.

class COleClientItem : public CDocItem

Mitglieder

Öffentliche Konstruktoren

Name	Description
COleClientItem::COleClientItem	Erstellt ein COleClientItem-Objekt.

Öffentliche Methoden

Name	Description
COleClientItem::Activate	Öffnet das OLE-Element für einen Vorgang und dann das angegebene Verb aus.
COleClientItem::ActivateAs	Ermöglicht das Element als anderer Typ.
COleClientItem::AttachDataObject	Greift auf die Daten im OLE-Objekt zu.
COleClientItem::CanCreateFromData	Gibt an, ob eine Containeranwendung ein eingebettetes Objekt erstellen kann.
COleClientItem::CanCreateLinkFromData	Gibt an, ob eine Containeranwendung ein verknüpftes Objekt erstellen kann.
COleClientItem::CanPaste	Gibt an, ob die Zwischenablage ein integrierbares oder statische OLE-Element enthält.
COleClientItem::CanPasteLink	Gibt an, ob die Zwischenablage ein verbindbares OLE-Element enthält.
COleClientItem::Close	Schließt, eine Verbindung zu einem Server jedoch zerstört nicht das OLE-Element.
COleClientItem::ConvertTo	Konvertiert das Element zu einem anderen Typ.
COleClientItem::CopyToClipboard	Kopiert das OLE-Element in die Zwischenablage.
COleClientItem::CreateCloneFrom	Stellt ein Duplikat eines vorhandenen Elements erstellt.
COleClientItem::CreateFromClipboard	Erstellt ein eingebettetes Element aus der Zwischenablage.
COleClientItem::CreateFromData	Erstellt ein eingebettetes Element aus einem Datenobjekt.
COleClientItem::CreateFromFile	Erstellt ein eingebettetes Element aus einer Datei.
COleClientItem::CreateLinkFromClipboard	Erstellt ein verknüpftes Element aus der Zwischenablage.
COleClientItem::CreateLinkFromData	Erstellt ein verknüpftes Element aus einem Datenobjekt.
COleClientItem::CreateLinkFromFile	Erstellt ein verknüpftes Element aus einer Datei.
COleClientItem::CreateNewItem	Erstellt ein neues eingebettetes Element starten, indem die Serveranwendung.
COleClientItem::CreateStaticFromClipboard	Erstellt ein statisches Element aus der Zwischenablage.
COleClientItem::CreateStaticFromData	Erstellt ein statisches Element aus einem Datenobjekt.
COleClientItem::Deactivate	Deaktiviert das Element.
COleClientItem::DeactivateUI	Stellt die Benutzeroberfläche der Containeranwendung in ihren ursprünglichen Zustand zurück.
COleClientItem::Delete	Löscht oder schließt das OLE-Element, wenn es ein verknüpftes Element war.
COleClientItem::DoDragDrop	Führt ein Drag & Drop-Vorgang aus.
COleClientItem::DoVerb	Führt das angegebene Verb aus.
COleClientItem::Draw	Zeichnet das OLE-Element.
COleClientItem::GetActiveView	Ruft die Ansicht ab, auf der das Element an der Stelle aktiviert ist.
COleClientItem::GetCachedExtent	Gibt die Grenzen des Rechtecks des OLE-Elements zurück.
COleClientItem::GetClassID	Ruft die ID Klasse des vorhandenen Elements ab
COleClientItem::GetClipboardData	Ruft die Daten ab, die in der Zwischenablage gespeichert werden, indem die CopyToClipboard-Memberfunktion aufgerufen wurde.
COleClientItem::GetDocument	Gibt das COleDocument-Objekt zurück, das das vorhandene Element enthält.
COleClientItem::GetDrawAspect	Ruft die aktuelle Ansicht des Elements zum Rendern ab.
COleClientItem::GetExtent	Gibt die Grenzen des Rechtecks des OLE-Elements zurück.
COleClientItem::GetIconFromRegistry	Retrives ein Handle für ein Symbol zugeordnet mit dem Server eines bestimmten CLSID.
COleClientItem::GetIconicMetafile	Ruft die Metadatei ab, die für das Zeichnen des Symbols des Elements verwendet wird.
COleClientItem::GetInPlaceWindow	Gibt einen Zeiger auf das Fenster der direkten Bearbeitung des Elements.
COleClientItem::GetItemState	Ruft den aktuellen Zustand des Elements ab.
COleClientItem::GetLastStatus	Gibt den Status des Vorgangs des letzten OLE zurück.
COleClientItem::GetLinkUpdateOptions	Gibt den Updatemodus für ein verknüpftes Element zurück (erweiterte Funktion).
COleClientItem::GetType	Gibt den Typ (eingebettet, verknüpft oder statisch) des OLE-Elements zurück.
COleClientItem::GetUserType	Ruft eine Zeichenfolge ab, die den Typ des Elements beschreibt.
COleClientItem::IsInPlaceActive	Gibt TRUE zurück, wenn das Element direkt aktiviert ist.
COleClientItem::IsLinkUpToDate	Gibt TRUE zurück, wenn ein verknüpftes Element mit dem Quelldokument auf dem neuesten Stand ist.
COleClientItem::IsModified	Gibt TRUE zurück, wenn das Element geändert wurde, seit er zuletzt gespeichert wurde.
COleClientItem::IsOpen	Gibt TRUE zurück, wenn das Element in der Serveranwendung geöffnet ist.
COleClientItem::IsRunning	Gibt TRUE zurück, wenn die Serveranwendung des Elements ausgeführt wird.
COleClientItem::OnActivate	Aufgerufen vom Framework, um das Element zu benachrichtigen, dass es aktiviert ist.
COleClientItem::OnActivateUI	Aufgerufen vom Framework, um das Element zu benachrichtigen, dass es aktiviert ist und die Benutzeroberfläche anzeigen soll.
COleClientItem::OnChange	Aufgerufen, wenn der Server das OLE-Element ändert. Implementierung erforderlich.
COleClientItem::OnDeactivate	Aufgerufen vom Framework ausgelöst, wenn ein Element deaktiviert wird.
COleClientItem::OnDeactivateUI	Aufgerufen vom Framework, wenn der Server die direkte Benutzeroberfläche entfernt wurde.
COleClientItem::OnGetClipboardData	Aufgerufen vom Framework, die in die Zwischenablage kopiert werden, Daten abzurufen.
COleClientItem::OnInsertMenus	Aufgerufen vom Framework, um ein zusammengesetztes Menü zu erstellen.
COleClientItem::OnRemoveMenus	Aufgerufen durch das Framework, um die Menüs des Containers von einem zusammengesetzten Menü zu entfernen.
COleClientItem::OnSetMenu	Aufgerufen vom Framework, um ein zusammengesetztes Menü zu installieren und zu entfernen.
COleClientItem::OnShowControlBars	Aufgerufen durch das Framework, um Steuerleisten ein- und auszublenden.
COleClientItem::OnUpdateFrameTitle	Aufgerufen vom Framework, um die Titelleiste des Rahmenfensters zu aktualisieren.
COleClientItem::ReactivateAndUndo	Aktiviert das Element und macht den letzten Vorgang der direkten Bearbeitung.
COleClientItem::Release	Gibt die Verbindung mit einem OLE verknüpften Element frei und schließt sie, wenn sie geöffnet wurde. Zerstört nicht das Clientelement.
COleClientItem::Reload	Lädt das Element nach einem Aufruf von ActivateAs erneut.
COleClientItem::Run	Führt die Anwendung aus, die dem Element zugeordnet wird.
COleClientItem::SetDrawAspect	Legt die aktuelle Ansicht des Elements zum Rendern fest.
COleClientItem::SetExtent	Legt das umschließende Rechteck des OLE-Elements fest.
COleClientItem::SetHostNames	Legt die Namen fest, die der Server anzeigt, wenn er das OLE-Element bearbeitet.
COleClientItem::SetIconicMetafile	Zwischenspeichert die Metadatei, die für das Zeichnen des Symbols des Elements verwendet wird.
COleClientItem::SetItemRects	Legt das umschließende Rechteck des Elements fest.
COleClientItem::SetLinkUpdateOptions	Legt den Updatemodus für ein verknüpftes Element fest (erweiterte Funktion).
COleClientItem::SetPrintDevice	Legt das DruckZiel Gerät für dieses Clientelement fest.
COleClientItem::UpdateLink	Aktualisiert den Präsentationscachen eines Elements.

Geschützte Methoden

Name	Description
COleClientItem::CanActivate	Aufgerufen vom Framework, um zu bestimmen, ob direkte Aktivierung zulässig ist.
COleClientItem::OnChangeItemPosition	Aufgerufen vom Framework, wenn die Position eines Elements ändert.
COleClientItem::OnDeactivateAndUndo	Aufgerufen durch das Framework, um nach Aktivierung rückgängig zu machen.
COleClientItem::OnDiscardUndoState	Aufgerufen vom Framework, um die Rückgängigzustandsinformationen des Elements zu verwerfen.
COleClientItem::OnGetClipRect	Aufgerufen vom Framework, um die Ausschneiderechteckkoordinaten des Elements abzurufen.
COleClientItem::OnGetItemPosition	Aufgerufen durch das Framework, um die Position des Elements relativ zur Ansicht abzurufen.
COleClientItem::OnGetWindowContext	Aufgerufen vom Framework, wenn ein Element an der Stelle aktiviert ist.
COleClientItem::OnScrollBy	Aufgerufen vom Framework, um das Element in einblenden.
COleClientItem::OnShowItem	Aufgerufen vom Framework, um das OLE-Element anzuzeigen.

Hinweise

Ein OLE-Element stellt die Daten dar, erstellt und von einer Serveranwendung verwaltet, die in ein Dokument "nahtlos" enthalten sein können, damit sie für den Benutzer angezeigt wird, ein einzelnes Dokument zu sein. Das Ergebnis ist ein "Verbunddokument", das vom OLE-Element und von einem enthaltenden Dokument gebildet wird.

Ein OLE-Element kann entweder eingebettet werden oder verknüpft sind. Wenn es eingebettet ist, werden die Daten als Teil des Verbunddokuments gespeichert. Wenn es verknüpft ist, werden die Daten als Teil einer separaten Datei gespeichert, die von der Serveranwendung erstellt wird, und nur ein Link zu dieser Datei wird im Verbunddokument gespeichert. Alle OLE-Elemente enthalten die Informationen, die die Serveranwendung angeben, die aufgerufen werden soll, um sie zu bearbeiten.

COleClientItem definiert mehrere überschreibbare Funktionen, die als Reaktion auf Anforderungen von der Serveranwendung aufgerufen werden; diese overridables treten normalerweise als Benachrichtigungen auf. Dies ermöglicht die Serveranwendung, den Container zu Änderungen zu informieren, die der Benutzer führt, wenn das OLE-Element bearbeitet, oder Informationen abzurufen, die während der Bearbeitung erforderlich sind.

COleClientItem kann mit der COleDocument, COleLinkingDoc oder COleServerDoc-Klasse verwendet werden. Um COleClientItem zu verwenden, leiten Sie eine Klasse davon und implementieren Sie die OnChange-Memberfunktion, die definiert wie der Container auf die Änderungen reagiert, die am Element vorgenommen werden. Um direkte Aktivierung zu unterstützen, überschreiben Sie die OnGetItemPosition-Memberfunktion. Diese Funktion bietet Informationen über die angezeigte Position des OLE-Elements.

Weitere Informationen zur Verwendung der Containerschnittstelle, finden Sie in Artikel Container: Implementieren eines Containers und Aktivierung.

Hinweis

Windows SDK bezeichnet die eingebetteten und verknüpften Elemente als "Objekte" verweist auf Typen von Elementen als "Klassen" an. Dieser Verweis wird der Begriff "Element", um die OLE-Entität vom entsprechenden C++-Objekt und dem Begriff "Typ" zu unterscheiden, um die OLE-Kategorie von der C++-Klasse zu unterscheiden.