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 .
Возвращаемое значение
Если метод завершается успешно, возвращает значение 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 .