OleComponent Classe
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.
Implémentation de base d’un jetable IOleComponent
public ref class OleComponent : Microsoft::VisualStudio::PlatformUI::DisposableObject, Microsoft::VisualStudio::OLE::Interop::IOleComponent, Microsoft::VisualStudio::Shell::Interop::IVsDiagnosticsItem
[Windows::Foundation::Metadata::WebHostHidden]
class OleComponent : Microsoft::VisualStudio::PlatformUI::DisposableObject, Microsoft::VisualStudio::OLE::Interop::IOleComponent, Microsoft::VisualStudio::Shell::Interop::IVsDiagnosticsItem
public class OleComponent : Microsoft.VisualStudio.PlatformUI.DisposableObject, Microsoft.VisualStudio.OLE.Interop.IOleComponent, Microsoft.VisualStudio.Shell.Interop.IVsDiagnosticsItem
type OleComponent = class
inherit DisposableObject
interface IOleComponent
interface IVsDiagnosticsItem
Public Class OleComponent
Inherits DisposableObject
Implements IOleComponent, IVsDiagnosticsItem
- Héritage
- Implémente
Remarques
Définit des méthodes virtuelles pour que les classes dérivées soient substituées afin de modifier le comportement. Définit également un événement public pour chaque méthode à laquelle les utilisateurs peuvent se connecter pour modifier le comportement sans dérivation. Les implémentations par défaut des méthodes virtuelles déclenchent simplement des événements en présence de gestionnaires. Si vous dérivez et substituez les méthodes et que vous souhaitez que les événements soient déclenchés, appelez la méthode de base avant ou après votre logique de substitution. Appellera FRegisterComponent(IOleComponent, OLECRINFO[], UInt32) sur la construction et FRevokeComponent(UInt32) sur et sur Dispose() .
Constructeurs
| OleComponent(IOleComponentManager, String) |
Construisez une instance de OleComponent . Cette surcharge appellera FRegisterComponent(IOleComponent, OLECRINFO[], UInt32) automatiquement à la construction. |
Propriétés
| DiagnosticsName |
Réservé à un usage interne Microsoft. |
| IsDisposed |
Retourne une valeur indiquant si l’objet a été supprimé une fois, protège contre les deux suppressions (Hérité de DisposableObject) |
| IsTrackingComponent |
Définit si ce composant est le composant de suivi, obtenu en appelant FSetTrackingComponent(UInt32, Int32) . |
| PeriodicIdleTimePeriod |
Définit ou récupère la période d’inactivité en millisecondes pour les rappels inactifs de ce composant. |
Méthodes
| Activate() |
Active le composant, effectué en appelant FOnComponentActivate(UInt32) . |
| BeginTracking() |
Fait de ce IOleComponent composant de suivi son associé IOleComponentManager . |
| CreateHostedComponent(String) |
Crée une OleComponent instance de à l’aide de Instance , car IOleComponentManager elle doit s’inscrire. |
| Dispose() |
Supprime l’objet actuel, puis supprime la finalisation supplémentaire. (Hérité de DisposableObject) |
| Dispose(Boolean) |
Surcharge virtuelle standard pour le IDisposable modèle (Hérité de DisposableObject) |
| DisposeManagedResources() |
Supprime cet objet, en appelant FRevokeComponent(UInt32) si notre champ Manager n’est pas null et que notre champ componentCookie n’a pas la valeur 0. |
| DisposeNativeResources() |
Permet aux classes dérivées de fournir une gestion de suppression personnalisée pour les ressources natives (Hérité de DisposableObject) |
| DoOleEvents(IOleComponentManager, Func<Boolean>) |
Pompe de messages pour un IOleComponentManager . AVERTISSEMENT : n’appelez pas cette méthode à moins qu’elle soit absolument nécessaire et que vous sachiez ce que vous faites. Le pompage des messages de l’interface utilisateur peut avoir des effets secondaires incorrects. Verr https://blogs.msdn.com/jfoscoding/archive/2005/08/06/448560.aspx |
| EndTracking() |
Rend ce IOleComponent n’est plus le composant de suivi associé à son associé IOleComponentManager . |
| FContinueMessageLoopCore(UInt32, IntPtr, MSG[]) |
Implémentation par défaut de FContinueMessageLoop. Déclenche simplement l' ContinueMessageLoop événement s’il existe des écouteurs. |
| FDoIdleCore(UInt32) |
Implémentation par défaut de FDoIdle. Déclenche simplement les DoIdle DoPeriodicIdle événements et selon les besoins (en fonction de la valeur de ) s’il existe des écouteurs. |
| FPreTranslateMessageCore(MSG[]) |
Implemmentation par défaut de FPreTranslateMessage. Déclenche simplement l' PreTranslateMessage événement s’il existe des écouteurs. |
| FQueryTerminateCore(Int32) |
Implemmentation par défaut de FQueryTerminate. Déclenche simplement l' QueryTerminate événement s’il existe des écouteurs. |
| HwndGetWindowCore(UInt32, UInt32) |
Implemmentation par défaut de HwndGetWindow. Déclenche simplement l' GetWindow événement s’il existe des écouteurs. |
| OnActivationChangeCore(IOleComponent, Int32, OLECRINFO[], Int32, OLECHOSTINFO[], UInt32) |
Implemmentation par défaut de OnActivationChange. Déclenche simplement l' ActivationChange événement s’il existe des écouteurs. |
| OnAppActivateCore(Int32, UInt32) |
Implemmentation par défaut de OnAppActivate. Déclenche simplement l' AppActivate événement s’il existe des écouteurs. |
| OnChangeStateCore(UInt32, Int32) |
Implemmentation par défaut de OnEnterState. Déclenche simplement l’événement appropriées en fonction de l’état modifié (décrit dans ComponentState . |
| OnLoseActivationCore() |
Implemmentation par défaut de OnLoseActivation. Déclenche simplement l' ActivationLost événement s’il existe des écouteurs. |
| PushMessageLoop(_OLELOOP, IntPtr) |
Exécute un push de ce composant dans le OleComonentManager en tant que gestionnaire de boucle de message en appelant FPushMessageLoop(UInt32, UInt32, IntPtr) . La boucle de message bloque jusqu’à ce qu’un ContinueMessageLoop Gestionnaire affecte la ContinuePumping valeur///à la valeur false. |
| TerminateCore() |
Implemmentation par défaut de l’arrêt. Déclenche simplement l' Terminate événement s’il existe des écouteurs. Appelle également Dispose() et null toute référence à un IOleComponentManager que nous avons pu construire avec. |
| ThrowIfDisposed() |
Lève un ObjectDisposedException si cet objet a été supprimé. (Hérité de DisposableObject) |
Événements
| ActivationChange |
Réservé à un usage interne Microsoft. |
| ActivationLost |
Réservé à un usage interne Microsoft. |
| AppActivate |
Réservé à un usage interne Microsoft. |
| ContinueMessageLoop |
Réservé à un usage interne Microsoft. |
| Disposing |
Déclenché lorsque l’événement est supprimé, alors qu’il est toujours accessible. (Hérité de DisposableObject) |
| DoIdle |
Réservé à un usage interne Microsoft. |
| DoPeriodicIdle |
Réservé à un usage interne Microsoft. |
| GetWindow |
Réservé à un usage interne Microsoft. |
| ModalStateChanged |
Réservé à un usage interne Microsoft. |
| PreTranslateMessage |
Réservé à un usage interne Microsoft. |
| QueryTerminate |
Réservé à un usage interne Microsoft. |
| RecordingStateChanged |
Réservé à un usage interne Microsoft. |
| RedrawOffStateChanged |
Réservé à un usage interne Microsoft. |
| Terminate |
Réservé à un usage interne Microsoft. |
| WarningsOffStateChanged |
Réservé à un usage interne Microsoft. |
Implémentations d’interfaces explicites
| IOleComponent.FContinueMessageLoop(UInt32, IntPtr, MSG[]) |
Appelée lors de chaque itération d’une boucle de messages que le composant a fait l’objet d’un push. Appelle simplement via FContinueMessageLoopCore(UInt32, IntPtr, MSG[]) . |
| IOleComponent.FDoIdle(UInt32) |
Appelée pour permettre à un composant d’effectuer des tâches de temps d’inactivité. Le composant peut appeler périodiquement FContinueIdle() ; si cette méthode retourne la valeur false (0), le composant doit mettre fin au traitement et au retour du temps d’inactivité. Appelle simplement via FDoIdleCore(UInt32) . |
| IOleComponent.FPreTranslateMessage(MSG[]) |
L’hôte appelle cette méthode sur le composant actif (si ses informations d’inscription ( ComponentRegistrationFlags ) indiquent qu’il est intéressé par les appels antérieurs à la traduction) pour permettre au composant de traiter les messages avant qu’ils ne soient traduits et distribués. L’hôte n’a pas besoin d’appeler cette méthode si aucun composant n’est actif. Appelle simplement via FPreTranslateMessageCore(MSG[]) . |
| IOleComponent.FQueryTerminate(Int32) |
Appelé lorsque le gestionnaire de composants souhaite savoir si le composant est dans un État dans lequel il peut s’arrêter. Appelle simplement via FQueryTerminateCore(Int32) . |
| IOleComponent.FReserved1(UInt32, UInt32, IntPtr, IntPtr) |
Emplacement réservé, non appelé. |
| IOleComponent.HwndGetWindow(UInt32, UInt32) |
Appelé pour récupérer une fenêtre associée au composant, comme spécifié par, |
| IOleComponent.OnActivationChange(IOleComponent, Int32, OLECRINFO[], Int32, OLECHOSTINFO[], UInt32) |
Notifie le composant lors de l’activation d’un nouvel objet. Appelle simplement via OnActivationChangeCore(IOleComponent, Int32, OLECRINFO[], Int32, OLECHOSTINFO[], UInt32) . |
| IOleComponent.OnAppActivate(Int32, UInt32) |
Notifie le composant lorsque l’application hôte gagne ou perd l’activation. Appelle simplement via OnAppActivateCore(Int32, UInt32) . |
| IOleComponent.OnEnterState(UInt32, Int32) |
Notifier le composant lorsque l’application entre ou quitte l’état indiqué dans |
| IOleComponent.OnLoseActivation() |
Notifie le composant actif qu’il a perdu son état actif, car l’ordinateur hôte ou un autre composant est devenu actif. Appelle simplement via OnLoseActivationCore() . |
| IOleComponent.Terminate() |
Appelé lorsque le gestionnaire de composants souhaite mettre fin à l’inscription du composant. Le composant doit révoquer son inscription auprès du gestionnaire de composants, mettre à jour les références au gestionnaire de composants et effectuer tout nettoyage nécessaire. Appelle simplement via TerminateCore() . |