返回下属性页在树视图中显示的类别下。
命名空间: Microsoft.VisualStudio.Shell.Interop
程序集: Microsoft.VisualStudio.Shell.Interop(在 Microsoft.VisualStudio.Shell.Interop.dll 中)
语法
声明
Function CategoryTitle ( _
iLevel As UInteger, _
<OutAttribute> ByRef pbstrCategory As String _
) As Integer
int CategoryTitle(
uint iLevel,
out string pbstrCategory
)
参数
- iLevel
类型:System.UInt32
[in] 包含级别的整数。
- pbstrCategory
类型:System.String%
[out, retval] 为 (文件夹) 的指针在下希望属性页上显示的类别。
返回值
类型:System.Int32
如果方法成功,则返回 S_OK。如果失败,它会返回一个错误代码。
备注
COM 签名
从 vsshell.idl:
HRESULT IVsPropertyPage::CategoryTitle(
[in]UINT iLevel,
[out, retval]BSTR *pbstrCategory
);
如果属性页不具有类别,并在树视图中的顶级会希望它显示直接在适当的顶部类别下,则首先实现单独 IPropertyPage 或返回从此方法的 E_NOTIMPL 。
否则,该环境首次调用与零的 iLevel 值的方法。
然后可以返回应是此页最接近的直接上级在树的类别的名称。
该环境然后将告知您具有 iLevel 值为一个。
如果您希望页缩进一级,则返回 S_FALSE。
该环境继续调用此方法,都递增 iLevel 的值的,除了之外, S_OK,直至返回的操作,或者您到达哪些环境的内部限制它支持。
返回 E_NOTIMPL 和 S_FALSE 停止处理,而不显示错误给用户。除了 S_OK 之外的任何值可能导致错误信息显示给用户。
当前环境仅支持类别的两个级别:
CatLevel1
CatLevel0
PageName
Visual Studio 类别,公共属性和配置属性,在该层次结构中 CatLevel1 上。为两个级别的一部分, Visual Studio 类别不计数。无法从 get_CategoryTitle将其返回。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。