IVsToolboxDataProvider2.GetItemID(IDataObject, String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
当用户从 IDE 的 "工具" 菜单上提供的 "导入/导出设置" 功能中选择 "导出" 选项时,由环境用来检索和保存给定工具箱选项卡的规范 ID。
public:
int GetItemID(Microsoft::VisualStudio::OLE::Interop::IDataObject ^ pDO, [Runtime::InteropServices::Out] System::String ^ % pbstrID);
int GetItemID(Microsoft::VisualStudio::OLE::Interop::IDataObject const & pDO, [Runtime::InteropServices::Out] std::wstring const & & pbstrID);
public int GetItemID (Microsoft.VisualStudio.OLE.Interop.IDataObject pDO, out string pbstrID);
abstract member GetItemID : Microsoft.VisualStudio.OLE.Interop.IDataObject * string -> int
Public Function GetItemID (pDO As IDataObject, ByRef pbstrID As String) As Integer
参数
- pDO
- IDataObject
中对应于工具箱项的数据对象。
- pbstrID
- String
弄"工具箱" 选项卡的区域设置固定规范 ID。
返回
如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。
注解
COM 签名
从 vsshell80:
HRESULT IVsToolboxDataProvider2::GetItemID(
[in] IDataObject *pDO,
[out] BSTR *pbstrID
);
IVsToolboxDataProvider2.GetItemID当用户选择 IDE 的 "导入/导出设置" 功能的导出选项时,环境将调用。
在设置导入时,环境将检索该 ID 并将其传递给 ReconstituteItem 方法以重新创建工具箱项。
作为返回的规范 ID pbstrID 不同于调用时定义的可本地化选项卡名称 AddTab 。
虽然规范选项卡名称必须是唯一的,但本地化的字符串会根据 IDE 运行时所处的区域设置而变化。
因此,规范 ID 必须是与区域设置无关的。
对于规范 ID 字符串的格式没有任何特定限制,可能会使用 GUID,或者可以使用开发人员的语言轻松记住的字符串。
任何创建 "工具箱" 选项卡的 VSPackage 都应调用 SetIDOfTab 。