IOleInPlaceComponentSite.SetUIMode(UInt32) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
更改就地 VSPackage 对象的 UI 模式。 当前不支持该方法。
public:
int SetUIMode(System::UInt32 dwUIMode);
public:
int SetUIMode(unsigned int dwUIMode);
int SetUIMode(unsigned int dwUIMode);
public int SetUIMode (uint dwUIMode);
abstract member SetUIMode : uint32 -> int
Public Function SetUIMode (dwUIMode As UInteger) As Integer
参数
- dwUIMode
- UInt32
中就地对象的 UI 模式标识符。
返回
如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。
注解
COM 签名
从 oleipc:
HRESULT IOleInPlaceComponentSite::SetUIMode(
[in] DWORD dwUIMode
);
因为当前不支持此方法,所以环境通过使对象 IVsWindowFrame 通过服务检索其容器的指针 SVsWindowFrame ,然后调用 SetProperty 并将 propid 参数设置为来 VSFPROPID_CmdUIGuid 处理对象的 UI 模式的更改。
如果支持,则就地对象在 SetUIMode 调用之前必须调用 UIActivateForMe 。 对象可以在的实现中首次执行此调用 UseComponentUIManager 。
参数的解释 dwUIMode 将是特定于 VSPackage 的。 环境通常具有其就地对象模式的编译时知识,并可将模式映射到特定的菜单和工具栏集。 环境可以安排为就地对象的各种 UI 模式提供不同的工具栏。 作为生成和拥有工具栏的一部分,环境提供了有关每个工具栏上的命令以及哪些命令组包含这些命令的详细信息。 需要特定工具栏上表示哪些命令组的知识,才能管理通过该服务协商的 UI 请求 SOleComponentUIManager 。