通过

IVsTrackSelectionEx.OnElementValueChange 方法

  • 项目

通知环境在元素值更改时发生。元素值附加到窗口中选择上下文的类似地用于更新环境的用户界面。

命名空间：  Microsoft.VisualStudio.Shell.Interop
程序集：  Microsoft.VisualStudio.Shell.Interop（在 Microsoft.VisualStudio.Shell.Interop.dll 中）

语法

声明
Function OnElementValueChange ( _
    elementid As UInteger, _
    fDontPropagate As Integer, _
    varValue As Object _
) As Integer

int OnElementValueChange(
    uint elementid,
    int fDontPropagate,
    Object varValue
)

参数

  • fDontPropagate
    类型：System.Int32
    [in] 标记指示是否应广播选定的值在环境中。如果设置为 true，在 varValue 中存储的信息与组件相关的保密。如果设置为 false， varValue 信息可用于该环境。
  • varValue
    类型：System.Object
    [in] 私有数据与 elementid定位的元素相关。

返回值

类型：System.Int32
如果方法成功，则返回 S_OK。如果失败，它会返回一个错误代码。

备注

COM 签名

从 vsshell.idl:

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

，其包含的帧变为活动状态时，编辑或工具会调用 OnElementValueChange 。

fDontPropagate 参数控制有关元素的信息是否发布在全局级或已保密。默认情况下，那么，当 windows 首先创建时，选择的任何元素设置 fDontPropagate 到 true 。管理在全局级由环境或其他 VSPackage 选择的元素应保持与 “DontPropagate”文档/工具窗口级别。例如， SolutionBuildManager 管理 SEID_StartupProject 元素并将该项目拥有的所有窗口 fDontPropagate 到 true。

由文档的上下文管理选择的元素应将设置为 fDontPropagate==false。例如，文档可能需要公开其 UndoManager 元素 (SEID_UndoManager)，以便其他窗口 (如窗口可以添加的属性取消事件向文档中撤消堆栈。注册选择事件的客户端得到通知，仅当 fDontPropagate 设置为 false时。

.NET Framework 安全性

请参见

参考

IVsTrackSelectionEx 接口

Microsoft.VisualStudio.Shell.Interop 命名空间