Partager via


conteneurs : états d'élément client

Cet article explique les différents états des tests d'un élément client dans sa durée de vie.

Un élément client transfère plusieurs conditions au moment de sa création, activé, modifié, et stocké. Chaque fois que les modifications d'état de l'élément, l'infrastructure appelle COleClientItem::OnChange avec notification d'OLE_CHANGED_STATE. Le deuxième paramètre est une valeur de l'énumération de COleClientItem::ItemState. Il peut avoir l'une des valeurs suivantes :

  • COleClientItem::emptyState

  • COleClientItem::loadedState

  • COleClientItem::openState

  • COleClientItem::activeState

  • COleClientItem::activeUIState

Si l'état est vide, un élément client n'est pas encore entièrement un élément. La mémoire a été allouée pour lui, mais elle n'a pas encore été initialisée avec les données OLE de l'élément. Il s'agit de l'état d'un élément client est dans le moment où il a été créé par un appel à new mais n'a pas encore induite la deuxième étape de la création en deux étapes classique.

Dans la deuxième étape, effectué par un appel à un COleClientItem::CreateFromFile ou une fonction différente de CreateFromxxxx, l'élément est complètement créé. Les données OLE (un fichier ou d'une autre source, tels que le presse-papiers) a été associée à COleClientItem- objet dérivé. Maintenant l'élément est dans l'état chargé.

Lorsqu'un élément a été ouvert dans la fenêtre du serveur au lieu d'ouverture sur place dans le document de conteneur, il se trouve dans (ou ouvrez entièrement) l'état ouvert. Dans cet état, une contre-taille généralement est dessinée sur les performances de l'élément dans la fenêtre du conteneur pour indiquer que l'élément est plus active.

Lorsqu'un élément a été activé sur place, il passe, généralement que brièvement, via l'état actif. Il passe à l'état actif de l'interface utilisateur, dans lequel le serveur a fusionné les menus, les barres d'outils, ainsi que d'autres composants de l'interface utilisateur avec celles du conteneur. La présence de ces composants d'interface utilisateur fait l'état actif de l'interface utilisateur de l'état actif. Sinon, l'état actif s'apparente à l'état actif de l'interface utilisateur. Si la restauration est supportée, le serveur est requis pour conserver les OLE des informations sur l'annulation de l'élément jusqu'à ce qu'il atteigne le chargement ou ouvrez l'état.

Voir aussi

Référence

CRectTracker, classe

Concepts

conteneurs

activation (C++)

conteneurs : notifications d'élément client

Mécanismes de traçage