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

Artigo
06/13/2016

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

Compartilhar via