Compartilhar via


Método IVsTrackSelectionEx.OnElementValueChange (UInt32, Int32, Object)

 

Informa o ambiente que ocorreu uma alteração em um valor do elemento.Os valores de elemento são anexados a contexto de seleção de uma janela e usados da mesma forma para atualizar a interface do usuário do ambiente.

Namespace:   Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

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

Parâmetros

  • elementid
    [in] Identificador do elemento que foi alterado.Para obter uma lista válida elementid valores, consulte VSConstants.VSSELELEMID.
  • fDontPropagate
    [in] Sinalizador que indica se ou não selecionado valores devem ser transmitidos em todo o ambiente.Se definido como true, as informações armazenadas em varValue relacionados ao elemento é mantido em sigilo.Se definido como false, o varValue informações sejam disponibilizadas para o ambiente.
  • varValue
    [in] Dados privados relacionados ao elemento identificado por elementid.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De vsshell.idl:

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

Um editor ou ferramenta chamadas OnElementValueChange quando seu quadro contendo se torna ativo.

O fDontPropagate parâmetro controla se as informações referentes ao elemento são publicadas no nível global ou mantidas privadas.Por padrão, todos os elementos da seleção definida fDontPropagate para true quando uma janela é criada pela primeira vez.Elementos de seleção que são gerenciados no nível global, o ambiente ou outro VSPackage deve permanecer com "DontPropagate" no nível da janela de ferramenta do documento.Por exemplo, o SolutionBuildManager gerencia a SEID_StartupProject elemento e conjuntos de fDontPropagate para todas as janelas de projeto para true.

Elementos de seleção que são gerenciados pelo contexto do documento devem ser definida como fDontPropagate= =false.Por exemplo, um documento talvez queira divulgar seu elemento UndoManager (SEID_UndoManager) para que outras janelas como, por exemplo, a janela propriedades podem adicionar ações de desfazer a pilha de desfazer do documento.Clientes que registraram para eventos de seleção são notificados somente quando fDontPropagate for definido como false.

Consulte também

Interface IVsTrackSelectionEx
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo