IOleInPlaceComponent.OnEnterState(UInt32, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Indique à un objet VSPackage sur place que l'environnement est entré dans un état ou a quitté un état.
public:
void OnEnterState(System::UInt32 dwStateId, int fEnter);
public:
void OnEnterState(unsigned int dwStateId, int fEnter);
void OnEnterState(unsigned int dwStateId, int fEnter);
public void OnEnterState (uint dwStateId, int fEnter);
abstract member OnEnterState : uint32 * int -> unit
Public Sub OnEnterState (dwStateId As UInteger, fEnter As Integer)
Paramètres
- dwStateId
- UInt32
[in] Identifie le nouvel état ou l'état antérieur. Pour obtenir la liste des dwStateId valeurs valides, consultez _OLECSTATE .
- fEnter
- Int32
dans Indicateur qui a la valeur true pour indiquer que l’environnement passe à l’état spécifié par dwStateId et false pour indiquer qu’il quitte l’État.
Remarques
Signature COM
À partir de oleipc. idl :
void IOleInPlaceComponent::OnEnterState(
[in] DWORD dwStateId,
[in] BOOL fEnter
);
L’environnement appelle la OnEnterState méthode pour notifier les objets sur place qu’une modification de l’État s’est produite. Si dwStateID a la valeur olecstateOnModal , une boîte de dialogue modale a été affichée. Les objets sur place doivent désactiver leur Windows de manière appropriée. Seuls les objets sur place de contrôle non composant sont avertis des changements d’État modaux avec OnEnterState . Les objets sur place de contrôle de composant sont avertis par le biais de EnableModeless .
Pour notifier l’environnement qu’un objet sur place passe à l’État modal, l’objet doit appeler OnUIComponentEnterState et définir le dwStateId paramètre avec la valeur olecstateOnModal . L’environnement est responsable de la notification de tous les autres objets sur place pour lesquels il est responsable de la modification d’État.
Lorsque le dwStateId paramètre a la valeur olecstateOnRedrawOff dans OnEnterState , cela indique que l’objet sur place doit désactiver la peinture de l’écran. Cet État est généralement entré par programme par un programmeur Visual Basic pour Applications définissant une propriété d’application. L’objet peut répondre à ce changement d’état de l’une des deux manières suivantes :
En masquant ses fenêtres de niveau supérieur sans forcer un redessin immédiat. Lorsque la peinture à l’écran est de nouveau activée, l’objet sur place peut forcer un redessin.
En interceptant tous les
WM_PAINTmessages, en définissant un indicateur sans redessiner si un message est reçu alors que la peinture est désactivée. Lorsque la peinture à l’écran est de nouveau activée, l’objet sur place peut reposer sur l’indicateur pour déterminer si un redessin est nécessaire.
Lorsque le dwStateId paramètre a la valeur olecstateOnWarningsOff , cela indique que l’objet sur place doit désactiver l’affichage des messages d’avertissement à l’utilisateur. L’environnement entre généralement cet État par programmation lorsqu’un programmeur Visual Basic pour Applications définit une propriété d’application. L’objet sur place exécute immédiatement sa réponse par défaut à la situation actuelle, tout ce qui peut l’être, au lieu d’afficher un message. Par exemple, si l’objet sur place se ferme actuellement, il doit enregistrer toutes les modifications non enregistrées, puis les fermer. L’objet ne doit pas afficher une boîte de dialogue qui vous demande si l’utilisateur souhaite enregistrer les modifications.