IVsTrackSelectionEx.OnElementValueChange(UInt32, Int32, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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 .