IVsTrackSelectionEx.OnElementValueChange(UInt32, Int32, Object) Methode

Definition

Informiert die Umgebung, dass eine Änderung in einem Elementwert eingetreten ist. Elementwerte werden dem Auswahlkontext eines Fensters angefügt und genauso verwendet, um die Benutzeroberfläche der Umgebung zu aktualisieren.

public:
 int OnElementValueChange(System::UInt32 elementid, int fDontPropagate, System::Object ^ varValue);
public:
 int OnElementValueChange(unsigned int elementid, int fDontPropagate, Platform::Object ^ varValue);
int OnElementValueChange(unsigned int elementid, int fDontPropagate, winrt::Windows::Foundation::IInspectable const & varValue);
public int OnElementValueChange (uint elementid, int fDontPropagate, object varValue);
abstract member OnElementValueChange : uint32 * int * obj -> int
Public Function OnElementValueChange (elementid As UInteger, fDontPropagate As Integer, varValue As Object) As Integer

Parameter

elementid
UInt32

[in] Bezeichner des geänderten Elements. Eine Liste der gültigen elementid Werte finden Sie unter VSConstants.VSSELELEMID .

fDontPropagate
Int32

[in] Flag, das angibt, ob ausgewählte Werte innerhalb der Umgebung übertragen werden. Wenn der Wert auf festgelegt true ist, werden die in varValue Bezug auf das Element gespeicherten Informationen privat aufbewahrt. Wenn diese Einstellung auf festgelegt false ist, werden die varValue Informationen der Umgebung zur Verfügung gestellt.

varValue
Object

in Private Daten, die mit dem durch identifizierten Element verknüpft sind elementid .

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

COM-Signatur

Aus vsshell. idl:

HRESULT IVsTrackSelectionEx::OnElementValueChange(  
   [in] VSSELELEMID elementid,  
   [in] BOOL fDontPropagate,  
   [in] VARIANT varValue  
);  

Ein Editor oder ein Tool Ruft auf, OnElementValueChange Wenn der enthaltende Frame aktiv wird.

Der- fDontPropagate Parameter steuert, ob Informationen, die sich auf das-Element beziehen, auf globaler Ebene veröffentlicht oder privat gehalten werden. Standardmäßig werden alle Elemente der Auswahl auf festgelegt, fDontPropagate true Wenn ein Fenster erstmalig erstellt wird. Elemente der Auswahl, die auf globaler Ebene von der Umgebung oder einem anderen VSPackage verwaltet werden, sollten auf der Dokument-/ToolWindows-Ebene mit "dontpropag" verbleiben. Der solutionbuildmanager verwaltet z SEID_StartupProject . b. das-Element und legt fDontPropagate für alle Fenster, die im Besitz des-Projekts sind, auf fest true .

Elemente der Auswahl, die im Kontext des Dokuments verwaltet werden, sollten auf festgelegt werden fDontPropagate == false . Ein Dokument könnte beispielsweise sein UndoManager-Element () veröffentlichen, SEID_UndoManager sodass andere Fenster wie die Eigenschaftenfenster dem Rückgängig-Stapel des Dokuments Rückgängig-Aktionen hinzufügen können. Clients, die sich für Auswahl Ereignisse registriert haben, werden nur benachrichtigt, wenn fDontPropagate auf festgelegt ist false .

Gilt für