OleComponent Classe

Définition

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
OleComponent
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, dwWhich qui correspond à une valeur dans WindowType . Appelle simplement via HwndGetWindowCore(UInt32, UInt32) .

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 uStateID . Appelle simplement via OnChangeStateCore(UInt32, Int32) .

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() .

S’applique à