OleComponent.IOleComponent.OnActivationChange(IOleComponent, Int32, OLECRINFO[], Int32, OLECHOSTINFO[], UInt32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Komponente Benachrichtigen, wenn ein neues Objekt aktiviert wird. Ruft einfach bis zu auf OnActivationChangeCore(IOleComponent, Int32, OLECRINFO[], Int32, OLECHOSTINFO[], UInt32) .
virtual void Microsoft.VisualStudio.OLE.Interop.IOleComponent.OnActivationChange(Microsoft::VisualStudio::OLE::Interop::IOleComponent ^ pic, int fSameComponent, cli::array <Microsoft::VisualStudio::OLE::Interop::OLECRINFO> ^ pcrinfo, int fHostIsActivating, cli::array <Microsoft::VisualStudio::OLE::Interop::OLECHOSTINFO> ^ pchostinfo, System::UInt32 dwReserved) = Microsoft::VisualStudio::OLE::Interop::IOleComponent::OnActivationChange;
virtual void Microsoft.VisualStudio.OLE.Interop.IOleComponent.OnActivationChange(Microsoft::VisualStudio::OLE::Interop::IOleComponent ^ pic, int fSameComponent, Platform::Array <Microsoft::VisualStudio::OLE::Interop::OLECRINFO> ^ pcrinfo, int fHostIsActivating, Platform::Array <Microsoft::VisualStudio::OLE::Interop::OLECHOSTINFO> ^ pchostinfo, unsigned int dwReserved) = Microsoft::VisualStudio::OLE::Interop::IOleComponent::OnActivationChange;
void Microsoft.VisualStudio.OLE.Interop.IOleComponent.OnActivationChange(Microsoft::VisualStudio::OLE::Interop::IOleComponent const & pic, int fSameComponent, std::Array <Microsoft::VisualStudio::OLE::Interop::OLECRINFO> const & pcrinfo, int fHostIsActivating, std::Array <Microsoft::VisualStudio::OLE::Interop::OLECHOSTINFO> const & pchostinfo, unsigned int dwReserved);
void IOleComponent.OnActivationChange (Microsoft.VisualStudio.OLE.Interop.IOleComponent pic, int fSameComponent, Microsoft.VisualStudio.OLE.Interop.OLECRINFO[] pcrinfo, int fHostIsActivating, Microsoft.VisualStudio.OLE.Interop.OLECHOSTINFO[] pchostinfo, uint dwReserved);
abstract member Microsoft.VisualStudio.OLE.Interop.IOleComponent.OnActivationChange : Microsoft.VisualStudio.OLE.Interop.IOleComponent * int * Microsoft.VisualStudio.OLE.Interop.OLECRINFO[] * int * Microsoft.VisualStudio.OLE.Interop.OLECHOSTINFO[] * uint32 -> unit
override this.Microsoft.VisualStudio.OLE.Interop.IOleComponent.OnActivationChange : Microsoft.VisualStudio.OLE.Interop.IOleComponent * int * Microsoft.VisualStudio.OLE.Interop.OLECRINFO[] * int * Microsoft.VisualStudio.OLE.Interop.OLECHOSTINFO[] * uint32 -> unit
Sub OnActivationChange (pic As IOleComponent, fSameComponent As Integer, pcrinfo As OLECRINFO(), fHostIsActivating As Integer, pchostinfo As OLECHOSTINFO(), dwReserved As UInteger) Implements IOleComponent.OnActivationChange
Parameter
- pic
- IOleComponent
Wenn NULL, dann ist dies die Komponente, die aktiviert ist.
- fSameComponent
- Int32
True, wenn pic ist die Komponente, die diese Methode aufgerufen hat.
- fHostIsActivating
- Int32
Wenn pic NULL ist und dieses ist TRUE (1), gibt das an, dass der Host sich aktiviert. Wenn pic NULL ist und dieses ist FALSE (0), dann gibt es kein aktuelles aktives Objekt.
- pchostinfo
- OLECHOSTINFO[]
Wenn fHostIsActivating TRUE (1) ist, ist dies die OLECHOSTINFO des Hosts; andernfalls ist dies NULL.
- dwReserved
- UInt32
Für zukünftige Verwendung reserviert, sollte 0 sein.
Implementiert
Hinweise
Wenn pic aktiviert wird und für pcrinfo GRF das ExclusiveBorderSpace Bit festgelegt ist, sollte die Komponente die Rahmen Raum Tools (Symbolleisten, Status leisten usw.) ausblenden. die Komponente sollte dies auch tun, wenn der Host aktiviert wird und für pchostinfo grfchost das ExclusiveBorderSpace Bit festgelegt ist. In jedem dieser Fälle sollte die Komponente die Rahmen Raum Tools beim nächsten aktivieren wieder einblenden.
Wenn pic aktiviert wird und für pcrinfo GRF das- ExclusiveActivation Bit festgelegt ist, pic wird im Modus "exclusiveactive" aktiviert. Die Komponente sollte das obere Rahmen Fenster abrufen, das gehostet wird pic (über den PIC). Hwndgetwindow (windowtypes. windowtoplevel, 0)). Wenn sich dieses Fenster von dem eigenen oberen Fenster der Komponente unterscheidet, sollte die Komponente die Fenster deaktivieren und andere Aufgaben ausführen, die beim Empfangen der OnEnterState-Benachrichtigung (componentstate. Modal, true) ausgeführt werden.
Andernfalls sollte die Komponente, wenn die Komponente die oberste Ebene ist, das Fenster aktivieren, indem WM_MOUSEACTIVATE ordnungsgemäß verarbeitet wird (siehe WM_MOUSEACTIVATE Hinweis unten). Die Komponente sollte in einem dieser Zustände verbleiben, bis der exclusiveaktive Modus endet. Dies wird durch einen zukünftigen Aufruf von OnActivationChange mit nicht festgelegten exclusiveactivation-Bit oder mit NULL angegeben. pcrinfo
WM_MOUSEACTIVATE Hinweis (für compoendents und Host auf oberster Ebene): Wenn die reg-Info des aktiven (oder nach verfolgten) COMP anzeigt, dass Sie Maus Nachrichten wünschen, sollte kein MA_xxxANDEAT Wert von WM_MOUSEACTIVATE zurückgegeben werden, damit die aktive (oder nach Verfolgungs-) COMP die resultierende Maus Nachricht verarbeiten kann. Wenn Sie die reg-Informationen nicht untersuchen möchten, sollte WM_MOUSEACTIVATE keine MA_xxxANDEAT Wert zurückgegeben werden, wenn ein Comp aktiv ist (oder nachverfolgt). Sie können die reg-Informationen der aktiven Komponente (oder nach Verfolgungs Komponente) jederzeit über iolecomponentmanager. fgetactivecomponent Abfragen.