COleServerDoc-Klasse

Artikel
02/26/2013

Die Basisklasse für OLE-Serverdokumente.

class AFX_NOVTABLE COleServerDoc : public COleLinkingDoc

Mitglieder

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Description
COleServerDoc::ActivateDocObject	Ermöglicht das zugeordnete DocObject-Dokument.
COleServerDoc::ActivateInPlace	Ermöglicht das Dokument für die direkte Bearbeitung.
COleServerDoc::DeactivateAndUndo	Deaktiviert die Benutzeroberfläche des Servers.
COleServerDoc::DiscardUndoState	Verwirft Rückgängigzustandsinformationen.
COleServerDoc::GetClientSite	Ruft einen Zeiger auf die zugrunde liegenden IOleClientSite-Schnittstelle ab.
COleServerDoc::GetEmbeddedItem	Gibt einen Zeiger auf ein Element zurück, das das gesamte Dokument darstellt.
COleServerDoc::GetItemClipRect	Gibt das aktuelle Ausschneiderechteck für die direkte Bearbeitung zurück.
COleServerDoc::GetItemPosition	Gibt das Rechteck der aktuellen Position, relativ zum Clientbereich der Containeranwendung, für die direkte Bearbeitung zurück.
COleServerDoc::GetZoomFactor	Gibt den Zoomfaktor in Pixel zurück.
COleServerDoc::IsDocObject	Bestimmt, ob das Dokument ein DocObject ist.
COleServerDoc::IsEmbedded	Gibt an, ob das Dokument in einem Containerdokument oder in einem derzeit ausgeführten eingebettet ist, die eigenständig sind.
COleServerDoc::IsInPlaceActive	Gibt TRUE zurück, wenn das Element direkt an der Stelle aktiviert ist.
COleServerDoc::NotifyChanged	Benachrichtigt Container, dass der Benutzer das Dokument geändert hat.
COleServerDoc::NotifyClosed	Benachrichtigt Container, dass der Benutzer das Dokument geschlossen hat.
COleServerDoc::NotifyRename	Benachrichtigt Container, dass der Benutzer das Dokument umbenannt wurde.
COleServerDoc::NotifySaved	Benachrichtigt Container, dass der Benutzer das Dokument gespeichert hat.
COleServerDoc::OnDeactivate	Aufgerufen vom Framework, wenn der Benutzer ein Element deaktiviert, das an der Stelle aktiviert wurde.
COleServerDoc::OnDeactivateUI	Aufgerufen vom Framework, um die Steuerelemente und andere Elemente zu zerstören erstellt für direkte Aktivierung.
COleServerDoc::OnDocWindowActivate	Aufgerufen vom Framework, wenn das Dokumentrahmenfenster des Containers aktiviert oder deaktiviert ist.
COleServerDoc::OnResizeBorder	Aufgerufen vom Framework, wenn der das Rahmenfenster oder das Dokumentfenster Containeranwendung angepasst wird.
COleServerDoc::OnShowControlBars	Aufgerufen durch das Framework, um Steuerleisten für die direkte Bearbeitung anzuzeigen oder auszublenden.
COleServerDoc::OnUpdateDocument	Aufgerufen vom Framework ausgelöst, wenn ein Serverdokument, das ein eingebettetes Element ist, gespeichert wird, die Kopie des Containers des Elements zu aktualisieren.
COleServerDoc::RequestPositionChange	Ändert die Position der Rahmen der direkten Bearbeitung.
COleServerDoc::SaveEmbedding	Teilt die Containeranwendung mit, das Dokument zu speichern.
COleServerDoc::ScrollContainerBy	Führt das Containerdokument aus.
COleServerDoc::UpdateAllItems	Benachrichtigt Container, dass der Benutzer das Dokument geändert hat.

Geschützte Methoden

Name	Description
COleServerDoc::CreateInPlaceFrame	Aufgerufen durch das Framework, um ein Rahmenfenster für die direkte Bearbeitung zu erstellen.
COleServerDoc::DestroyInPlaceFrame	Aufgerufen durch das Framework, um ein Rahmenfenster für die direkte Bearbeitung zu zerstören.
COleServerDoc::GetDocObjectServer	Überschreiben Sie diese Funktion, um ein neues Objekt zu erstellen CDocObjectServer und anzugeben, dass dieses Dokument ein DocObject-Container ist.
COleServerDoc::OnClose	Aufgerufen vom Framework wenn Anforderungen eines Containers, das Dokument zu schließen.
COleServerDoc::OnExecOleCmd	Führt einen angegebenen Befehl aus, oder Anzeigen von für den Befehl.
COleServerDoc::OnFrameWindowActivate	Aufgerufen vom Framework, wenn das Rahmenfenster des Containers aktiviert oder deaktiviert ist.
COleServerDoc::OnGetEmbeddedItem	Aufgerufen, um COleServerItem abzurufen, das das gesamte Dokument darstellt; verwendet, um ein eingebettetes Element abzurufen.Implementierung erforderlich.
COleServerDoc::OnReactivateAndUndo	Aufgerufen vom Framework, um die Änderungen rückgängig zu machen vorgenommen während der direkten Bearbeitung.
COleServerDoc::OnSetHostNames	Aufgerufen vom Framework ausgelöst, wenn ein Container den Fenstertitel für ein eingebettetes Objekt festgelegt wird.
COleServerDoc::OnSetItemRects	Aufgerufen vom Framework, um das Rahmenfenster der direkten Bearbeitung innerhalb des Fensters der Containeranwendung zu positionieren.
COleServerDoc::OnShowDocument	Aufgerufen vom Framework, um das Dokument anzuzeigen oder auszublenden.

Hinweise

Ein Serverdokument kann COleServerItem-Objekte enthalten, die die eingebetteten oder verknüpfte Elemente der Serverschnittstelle darstellen.Wenn eine Serveranwendung durch einen Container, ein eingebettetes Element bearbeiten gestartet wird, wird das Element als sein eigenes Serverdokument geladen; das COleServerDoc-Objekt enthält nur ein COleServerItem-Objekt und besteht aus dem gesamten Dokument.Wenn eine Serveranwendung durch einen Container, ein verknüpftes Element bearbeiten gestartet wird, wird ein vorhandenes Dokument vom Datenträger geladen; ein Teil des Inhalts des Dokuments wird hervorgehoben, um das verknüpfte Element anzugeben.

COleServerDoc-Objekte können Elemente der COleClientItem-Klasse auch enthalten.Dies ermöglicht es Ihnen, ContainerServer Anwendungen zu erstellen.Das Framework bietet Funktionen, um die COleClientItem-Elemente, während COleServerItem Wartung ordnungsgemäß gespeichert werden.

Wenn die Serveranwendung nicht Links vornimmt, enthält ein Serverdokument immer nur ein Serverelement, das das gesamte eingebettete Objekt als Dokument darstellt.Wenn die Serveranwendung Links vornimmt, muss sie ein Serverelement erstellen, wenn eine Auswahl in die Zwischenablage kopiert wird.

Um COleServerDoc zu verwenden, leiten Sie eine Klasse davon und implementieren Sie die OnGetEmbeddedItem-Memberfunktion, die den Server zu Unterstützung eingebetteten Elemente zulässig.Leiten Sie eine Klasse von COleServerItem, um die Elemente in Dokumenten zu implementieren, und geben Sie Objekte dieser Klasse von OnGetEmbeddedItem zurück.

Zur Unterstützung verknüpfte Elemente, COleServerDoc bereitstellt OnGetLinkedItem die Memberfunktion.Sie können die Standardimplementierung verwenden oder sie überschreiben, wenn Sie eine eigene Methode Verwaltung von Dokumentelementen haben.

Sie benötigen ein COleServerDoc von abgeleitete Klasse für jeden Typ Serverdokument die Anwendung unterstützt.Wenn die Serveranwendung Arbeitsblätter und Diagramme unterstützt, benötigen Sie zwei COleServerDoc von abgeleitete Klassen.

Weitere Informationen zu Server, finden Sie im Artikel Server: Implementieren eines Servers.