Classe di COleServerDoc

Articolo
02/19/2013

La classe base per i documenti del server OLE.

class AFX_NOVTABLE COleServerDoc : public COleLinkingDoc

Membri

Costruttori pubblici

Nome	Descrizione
COleServerDoc::COleServerDoc	Costruisce un oggetto COleServerDoc.

Metodi pubblici

Nome	Descrizione
COleServerDoc::ActivateDocObject	Attiva il documento collegato di DocObject.
COleServerDoc::ActivateInPlace	Attiva il documento per la modifica sul posto.
COleServerDoc::DeactivateAndUndo	Disattiva l'interfaccia utente del server.
COleServerDoc::DiscardUndoState	Informazioni della fase di rollback- stato di rifiuta.
COleServerDoc::GetClientSite	Recupera un puntatore a interfaccia sottostante IOleClientSite.
COleServerDoc::GetEmbeddedItem	Restituisce un puntatore a un elemento che rappresenta l'intero documento.
COleServerDoc::GetItemClipRect	Restituisce il rettangolo di ridimensionamento corrente per la modifica sul posto.
COleServerDoc::GetItemPosition	Restituisce il rettangolo di posizione corrente, relativo all'area client dell'applicazione contenitore, per la modifica sul posto.
COleServerDoc::GetZoomFactor	Restituisce il fattore di zoom in pixel.
COleServerDoc::IsDocObject	Determina se il documento è un DocObject.
COleServerDoc::IsEmbedded	Indica se il documento è incorporato in un documento contenitore o in un computer autonomo.
COleServerDoc::IsInPlaceActive	Restituisce TRUE se l'elemento è attualmente attivo sul posto.
COleServerDoc::NotifyChanged	Notifica ai contenitori che l'utente ha modificato il documento.
COleServerDoc::NotifyClosed	Notifica ai contenitori che l'utente ha chiuso il documento.
COleServerDoc::NotifyRename	Notifica ai contenitori che l'utente ha modificato il documento.
COleServerDoc::NotifySaved	Notifica ai contenitori che l'utente ha salvato il documento.
COleServerDoc::OnDeactivate	Chiamato dal framework quando l'utente disabilita un elemento è stato attivato sul posto.
COleServerDoc::OnDeactivateUI	Chiamato dal framework per eliminare i controlli e altri elementi di interfaccia utente creati per l'attivazione sul posto.
COleServerDoc::OnDocWindowActivate	Chiamato dal framework quando la finestra cornice di documento client è attivata o disattivata.
COleServerDoc::OnResizeBorder	Chiamato dal framework quando la finestra cornice o la finestra del documento dell'applicazione contenitore viene ridimensionata.
COleServerDoc::OnShowControlBars	Chiamato dal framework per visualizzare o nascondere le barre di controllo per la modifica sul posto.
COleServerDoc::OnUpdateDocument	Chiamato dal framework quando un documento server che è un elemento incorporato viene salvato, aggiornando la copia del contenitore dell'elemento.
COleServerDoc::RequestPositionChange	Modifica la posizione della modifica sul posto.
COleServerDoc::SaveEmbedding	Indica all'applicazione contenitore salvare il documento.
COleServerDoc::ScrollContainerBy	Scorre il documento contenitore.
COleServerDoc::UpdateAllItems	Notifica ai contenitori che l'utente ha modificato il documento.

Metodi protetti

Nome	Descrizione
COleServerDoc::CreateInPlaceFrame	Chiamato dal framework per creare una finestra cornice per la modifica sul posto.
COleServerDoc::DestroyInPlaceFrame	Chiamato dal framework per eliminare una finestra cornice per la modifica sul posto.
COleServerDoc::GetDocObjectServer	Eseguire l'override della funzione per creare un nuovo oggetto CDocObjectServer e per indicare che il documento è un contenitore di DocObject.
COleServerDoc::OnClose	Chiamato dal framework quando richieste di un contenitore di chiudere il documento.
COleServerDoc::OnExecOleCmd	Esegue un comando specificato o consente di visualizzare per il comando.
COleServerDoc::OnFrameWindowActivate	Chiamato dal framework quando la finestra cornice del contenitore viene attivata o disattivata.
COleServerDoc::OnGetEmbeddedItem	Chiamato per ottenere COleServerItem che rappresenta l'intero documento; utilizzato per ottenere un elemento incorporato.Implementazione richiesta.
COleServerDoc::OnReactivateAndUndo	Chiamato dal framework per annullare le modifiche apportate durante la modifica sul posto.
COleServerDoc::OnSetHostNames	Chiamato dal framework quando un contenitore imposta il titolo per un oggetto incorporato.
COleServerDoc::OnSetItemRects	Chiamato dal framework per posizionare la finestra al posto della cornice per la modifica nella finestra dell'applicazione contenitore.
COleServerDoc::OnShowDocument	Chiamato dal framework per visualizzare o nascondere il documento.

Note

Un documento server può contenere oggetti COleServerItem, che rappresentano l'interfaccia server a incorporato o agli elementi collegati.Quando un'applicazione server viene avviata da un contenitore modificare un elemento incorporato, l'elemento viene caricato come proprio documento server; l'oggetto COleServerDoc contiene un solo oggetto COleServerItem, composto da un intero documento.Quando un'applicazione server viene avviata da un contenitore modificare un elemento collegato, un documento esistente viene caricato da disco, una parte contenuto del documento viene evidenziata per indicare l'elemento collegato.

Gli oggetti diCOleServerDoc possono inoltre contenere elementi della classe COleClientItem.Consente di creare applicazioni di contenitore- server.Il framework fornisce funzioni correttamente per archiviare gli elementi COleClientItem come ulteriore COleServerItem oggetti.

Se l'applicazione server non fa collegamenti di supporto, un documento server conterrà sempre un solo elemento server, che rappresenta l'intero oggetto incorporato come documento.Se l'applicazione server vengono forniti collegamenti di supporto, deve creare un elemento server ogni volta una selezione viene copiata negli Appunti.

Per utilizzare COleServerDoc, derivare una classe da e implementare la funzione membro OnGetEmbeddedItem, che consente al server supportano gli elementi incorporati.Derivare la classe da COleServerItem per distribuire gli elementi nei documenti e restituire oggetti della classe da OnGetEmbeddedItem.

Per supportare gli elementi collegati, COleServerDoc fornisce la funzione membro OnGetLinkedItem.È possibile utilizzare l'implementazione predefinita o eseguirne l'override se si dispone della propria modalità di gestione degli elementi del documento.

È necessario un COleServerDocclasse derivata da per ogni tipo di documento server i supporti di applicazione.Ad esempio, se l'applicazione server supporta i fogli di lavoro e grafici, sono necessari due COleServerDocdi classi derivate.

Per ulteriori informazioni sui server, vedere l'articolo server: Implementazione di un server.