ICategorizeProperties.GetCategoryName Method

Artikel
12/17/2007

Returns a BSTR containing the category name.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

'Declaration
Function GetCategoryName ( _
    PROPCAT As Integer, _
    lcidCategory As UInteger, _
    <OutAttribute> ByRef pbstrName As String _
) As Integer
'Usage
Dim instance As ICategorizeProperties
Dim PROPCAT As Integer
Dim lcidCategory As UInteger
Dim pbstrName As String
Dim returnValue As Integer

returnValue = instance.GetCategoryName(PROPCAT, _
    lcidCategory, pbstrName)

int GetCategoryName(
    int PROPCAT,
    uint lcidCategory,
    out string pbstrName
)

int GetCategoryName(
    [InAttribute] int PROPCAT, 
    [InAttribute] unsigned int lcidCategory, 
    [OutAttribute] String^% pbstrName
)

function GetCategoryName(
    PROPCAT : int, 
    lcidCategory : uint, 
    pbstrName : String
) : int

Parameters

PROPCAT
Type: System.Int32

[in] Specifies the property category.

lcidCategory
Type: System.UInt32

pbstrName
Type: System.String%

[out] Pointer to a string containing the category name.

Return Value

Type: System.Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From objext.idl:

HRESULT ICategorizeProperties::GetCategoryName(
   [in] PROPCAT propcat, 
   [in] LCID lcid, 
   [out] BSTR* pbstrName
);

The GetCategoryName method returns a BSTR containing the category name. There are 11 predefined property categories with negative values. You can define your own custom categories, but you must assign positive values to them. The predefined categories are:

Category	Value
PROPCAT_Nil	-1
PROPCAT_Misc	-2
PROPCAT_Font	-3
PROPCAT_Position	-4
PROPCAT_Appearanc	-5
PROPCAT_Behavior	-6
PROPCAT_Data	-7
PROPCAT_List	-8
PROPCAT_Text	-9
PROPCAT_Scale	-10
PROPCAT_DDE	-11

Permissions

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Freigeben über