Udostępnij za pośrednictwem

Metoda IVsTrackSelectionEx.OnElementValueChange — (UInt32, Int32, Object)

  • Artykuł

 

Informuje, że nastąpiła zmiana w wartości elementu środowiska.Wartości elementów są dołączane do okno wyboru kontekstu i wykorzystywane w taki sam sposób aktualizacji w interfejsie użytkownika środowiska.

Przestrzeń nazw:   Microsoft.VisualStudio.Shell.Interop
Zestaw:  Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

int OnElementValueChange(
    uint elementid,
    int fDontPropagate,
    object varValue
)

int OnElementValueChange(
    unsigned int elementid,
    int fDontPropagate,
    Object^ varValue
)

abstract OnElementValueChange : 
        elementid:uint32 *
        fDontPropagate:int *
        varValue:Object -> int

Function OnElementValueChange (
    elementid As UInteger,
    fDontPropagate As Integer,
    varValue As Object
) As Integer

Parametry

  • elementid
    [w] Identyfikator elementu, który uległ zmianie.Lista z prawidłowych elementid wartości, zobacz VSConstants.VSSELELEMID.
  • fDontPropagate
    [w] Flagę wskazującą niezależnie od tego, czy zaznaczone, że wartości należy emitować w całym środowisku.Jeśli ustawiona na true, informacje przechowywane w varValue odnoszących się do elementu jest poufna.Jeśli ustawiona na false, varValue informacje były dostępne dla środowiska naturalnego.
  • varValue
    [w] Dane prywatne są związane z elementu, identyfikowane przez elementid.

Wartość zwracana

Type: System.Int32

Jeśli metoda się powiedzie, zwraca S_OK.Jeśli nie powiedzie się, zwraca kod błędu.

Uwagi

Podpis COM

Z vsshell.idl:

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

Edytor lub wywołania narzędzia OnElementValueChange podczas jego ramki zawierającej staje się aktywny.

fDontPropagate Parametr kontroluje, czy informacje odnoszące się do elementu jest publikowane na poziomie globalnym lub poufna.Domyślnie, wszystkie elementy zaznaczenia ustawić fDontPropagate do true kiedy okno jest tworzony po raz pierwszy.Elementy zaznaczenia, które są zarządzane na poziomie globalnym, środowiska naturalnego lub innego VSPackage powinna pozostać z "DontPropagate" na poziomie okno document i tool.Na przykład SolutionBuildManager zarządza SEID_StartupProject element i zestawy fDontPropagate dla wszystkich okien, posiadane przez program project, aby true.

Elementy zaznaczenia, które są zarządzane przez kontekście dokument powinien być ustawiony na fDontPropagate==false.Na przykład, dokument może być reklamującego z jego elementu UndoManager (SEID_UndoManager), dzięki czemu inne systemu windows, takich jak okno właściwości można dodawać cofanie akcji do dokumentu Cofnij.Klienci którzy zarejestrowali dla zdarzenia zaznaczenia są powiadamiani tylko wtedy, gdy fDontPropagate jest ustawiona na false.

Zobacz też

Interfejs IVsTrackSelectionEx
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku