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

Definição

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

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

Parâmetros

elementid
UInt32

no Identificador do elemento que foi alterado. Para obter uma lista de elementid valores válidos, consulte VSConstants.VSSELELEMID .

fDontPropagate
Int32

no Sinalizador que indica se os valores selecionados devem ser transmitidos em todo o ambiente ou não. Se definido como true , as informações armazenadas em varValue relacionadas ao elemento são mantidas privadas. Se definido como false , as varValue informações são disponibilizadas para o ambiente.

varValue
Object

no Dados privados relacionados ao elemento identificado por elementid .

Retornos

Int32

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

Comentários

Assinatura COM

De VSShell. idl:

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

Um editor ou uma ferramenta chama OnElementValueChange quando o quadro que o contém se torna ativo.

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

Os elementos de seleção que são gerenciados pelo contexto do documento devem ser definidos como fDontPropagate == false . Por exemplo, um documento pode querer publicamente seu elemento UndoManager ( SEID_UndoManager ) para que outras janelas, como a janela Propriedades, possam adicionar ações de desfazer à pilha de desfazer do documento. Clientes que se registraram para eventos de seleção são notificados somente quando fDontPropagate é definido como false .

Aplica-se a