IVsTrackSelectionEx.OnElementValueChange(UInt32, Int32, Object) Метод

Определение

Информирует среду, что произошло изменение в значении элемента. Значения элементов присоединяются к контексту выбора окна и используется аналогичным образом для обновления пользовательского интерфейса среды.

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

Параметры

elementid
UInt32

[in] Идентификатор измененного элемента. Список допустимых elementid значений см. в разделе VSConstants.VSSELELEMID .

fDontPropagate
Int32

[in] Флаг, указывающий, необходимо ли вещание выбранных значений в среде. Если задано значение true , сведения, хранящиеся в varValue отношении элемента, остаются закрытыми. Если задано значение false , varValue информация становится доступной для среды.

varValue
Object

окне Закрытые данные, связанные с элементом, идентифицируемым elementid .

Возвращаемое значение

Int32

Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.

Комментарии

Подпись COM

Из всшелл. IDL:

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

Редактор или средство вызывает, OnElementValueChange когда его вмещающий фрейм станет активным.

fDontPropagateПараметр определяет, публикуются ли сведения, относящиеся к элементу, на глобальном уровне или остаются закрытыми. По умолчанию все элементы выбора устанавливаются fDontPropagate в значение true при первом создании окна. Элементы выбора, которые управляются на глобальном уровне средой или другим VSPackage, должны остаться с "Донтпропагате" на уровне окна документа/средства. Например, солутионбуилдманажер управляет SEID_StartupProject элементом и задается fDontPropagate для всех окон, принадлежащих проекту, в true .

Элементам выбора, управляемым с помощью контекста документа, должно быть присвоено значение fDontPropagate == false . Например, документ может захотеть содокументировать свой элемент UndoManager (), SEID_UndoManager чтобы другие окна, такие как окно свойств, могли добавлять действия отмены в стек отмены документа. Клиенты, зарегистрированные для событий выбора, получают уведомления только в том случае, если параметр fDontPropagate имеет значение false .

Применяется к