Classe de COleServerDoc

Article
03/04/2013

La classe de base pour les documents OLE serveur.

class AFX_NOVTABLE COleServerDoc : public COleLinkingDoc

Membres

Constructeurs publics

Nom	Description
COleServerDoc::COleServerDoc	Construit un objet COleServerDoc.

Méthodes publiques

Nom	Description
COleServerDoc::ActivateDocObject	Lance le document associé de DocObject.
COleServerDoc::ActivateInPlace	Lance le document pour la modification sur place.
COleServerDoc::DeactivateAndUndo	Place l'interface utilisateur du serveur.
COleServerDoc::DiscardUndoState	Ignore les informations d'état d'annulation.
COleServerDoc::GetClientSite	Extrait un pointeur vers l'interface sous-jacente d' IOleClientSite .
COleServerDoc::GetEmbeddedItem	Retourne un pointeur vers un élément représentant le document entier.
COleServerDoc::GetItemClipRect	Retourne le rectangle de découpage actuel pour la modification sur place.
COleServerDoc::GetItemPosition	Retourne le rectangle de position actuelle, par rapport à la zone cliente de l'application conteneur, pour la modification sur place.
COleServerDoc::GetZoomFactor	Retourne le facteur de zoom en pixels.
COleServerDoc::IsDocObject	Détermine si le document est DocObject.
COleServerDoc::IsEmbedded	Indique si le document est incorporé dans un document ou un conteneur qui autonome.
COleServerDoc::IsInPlaceActive	Retourne TRUE si l'élément est actuellement exécuté en place.
COleServerDoc::NotifyChanged	Prévient les conteneurs que l'utilisateur a modifié le document.
COleServerDoc::NotifyClosed	Prévient les conteneurs que l'utilisateur a fermé le document.
COleServerDoc::NotifyRename	Prévient les conteneurs que l'utilisateur a renommé le document.
COleServerDoc::NotifySaved	Prévient les conteneurs que l'utilisateur a enregistré le document.
COleServerDoc::OnDeactivate	Appelé par l'infrastructure lorsque l'utilisateur place un élément qui a été démarré en place.
COleServerDoc::OnDeactivateUI	Appelé par l'infrastructure pour détruire des contrôles et d'autres éléments d'interface utilisateur l'a créée pour l'activation sur place.
COleServerDoc::OnDocWindowActivate	Appelé par l'infrastructure lorsque la fenêtre frame de document du conteneur est activée ou désactivée.
COleServerDoc::OnResizeBorder	Appelé par l'infrastructure lorsque la fenêtre frame ou la fenêtre de document de l'application conteneur est redimensionnée.
COleServerDoc::OnShowControlBars	Appelé par l'infrastructure pour afficher ou masquer des barres de contrôles pour la modification sur place.
COleServerDoc::OnUpdateDocument	Appelé par l'infrastructure lorsqu'un document serveur qui est un élément inclus est enregistré, la mise à jour la copie du conteneur de l'élément.
COleServerDoc::RequestPositionChange	Modifie la position du frame de modification sur place.
COleServerDoc::SaveEmbedding	Indique l'application conteneur d'enregistrer le document.
COleServerDoc::ScrollContainerBy	Fait défiler le document conteneur.
COleServerDoc::UpdateAllItems	Prévient les conteneurs que l'utilisateur a modifié le document.

Méthodes protégées

Nom	Description
COleServerDoc::CreateInPlaceFrame	Appelé par l'infrastructure pour créer une fenêtre frame pour la modification sur place.
COleServerDoc::DestroyInPlaceFrame	Appelé par l'infrastructure pour détruire une fenêtre frame pour la modification sur place.
COleServerDoc::GetDocObjectServer	Remplacez cette fonction pour créer un nouvel objet d' CDocObjectServer et pour indiquer que ce document est un conteneur de DocObject.
COleServerDoc::OnClose	Appelé par l'infrastructure lorsque demandes d'un conteneur de fermer le document.
COleServerDoc::OnExecOleCmd	Exécute une commande spécifiée ou les affichages permettent de la commande.
COleServerDoc::OnFrameWindowActivate	Appelé par l'infrastructure lorsque la fenêtre frame du conteneur est activée ou désactivée.
COleServerDoc::OnGetEmbeddedItem	Appelé pour obtenir COleServerItem qui représente le document entier ; utilisé pour obtenir un élément inline.Implémentation requise.
COleServerDoc::OnReactivateAndUndo	Appelé par l'infrastructure pour annuler les modifications apportées pendant la modification sur place.
COleServerDoc::OnSetHostNames	Appelé par l'infrastructure lorsqu'un conteneur affecte le titre de la fenêtre pour un objet incorporé.
COleServerDoc::OnSetItemRects	Appelé par l'infrastructure pour positionner la fenêtre frame de modification sur place dans la fenêtre de l'application conteneur.
COleServerDoc::OnShowDocument	Appelé par l'infrastructure pour afficher ou masquer le document.

Notes

Un document serveur peut contenir des objets de COleServerItem , qui représentent l'interface de serveur à un incorporé ou des éléments liés.Lorsqu'une application serveur est lancée par un conteneur de modifier un élément inline, l'élément est chargé comme son propre document serveur ; l'objet d' COleServerDoc contient un seul objet d' COleServerItem , comprenant le document entier.Lorsqu'une application serveur est lancée par un conteneur de modifier un élément lié, un document existant est chargé à partir de le disque ; une partie du contenu du document est mise en surbrillance pour indiquer l'élément lié.

Les objets d'COleServerDoc peuvent également contenir des éléments de la classe de COleClientItem .Cela vous permet de créer des applications aux conteneurs de serveur.L'infrastructure fournit des fonctions pour signaler correctement les éléments d' COleClientItem en entretenant COleServerItem objets.

Si votre application serveur ne fait pas en charge, un document serveur contient toujours un seul élément du serveur, qui représente l'objet incorporé entier comme un document.Si votre application serveur fait en charge, elle doit créer un élément du serveur chaque fois qu'une sélection est copié dans le presse-papiers.

Pour utiliser COleServerDoc, dérivez une classe de celle-ci et implémentez la fonction membre d' OnGetEmbeddedItem , qui permet à votre serveur aux éléments inclus par prise en charge.Dérivez une classe d' COleServerItem pour implémenter des éléments dans vos documents, et retournez les objets de cette classe d' OnGetEmbeddedItem.

Pour prendre en charge des éléments liés, COleServerDoc fournit la fonction membre d' OnGetLinkedItem .Vous pouvez utiliser l'implémentation par défaut ou la substituer si vous avez votre propre façon de gérer les éléments du document.

Vous avez besoin d'un COleServerDocclasse dérivée pour chaque type de document serveur prise en charge par votre application.Par exemple, si votre application serveur prend en charge les feuilles de calcul et des graphiques, vous avez besoin de deux COleServerDoc- classes dérivées.

Pour plus d'informations sur les serveurs, consultez l'article serveurs : implémenter un serveur.