ICategorizeProperties.MapPropertyToCategory(Int32, Int32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns the property category value for the specified property.
public:
int MapPropertyToCategory(int dispid, [Runtime::InteropServices::Out] int % ppropcat);
int MapPropertyToCategory(int dispid, [Runtime::InteropServices::Out] int & ppropcat);
public int MapPropertyToCategory (int dispid, out int ppropcat);
abstract member MapPropertyToCategory : int * int -> int
Public Function MapPropertyToCategory (dispid As Integer, ByRef ppropcat As Integer) As Integer
Parameters
- dispid
- Int32
[in] Specifies the dispatch ID of the property to be displayed.
- ppropcat
- Int32
[out] Specifies a pointer to the property category.
Returns
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
COM Signature
From objext.idl:
HRESULT ICategorizeProperties::MapPropertyToCategory(
[in] DISPID dispid,
[out] PROPCAT* ppropcat
);
The MapPropertyToCategory
method returns the appropriate property category value for the specified property. There are 11 predefined property categories with negative values. You can define your own custom categories, but you must assign them positive values. The predefined categories are:
Category | Value |
---|---|
PROPCAT_Nil |
-1 |
PROPCAT_Misc |
-2 |
PROPCAT_Font |
-3 |
PROPCAT_Position |
-4 |
PROPCAT_Appearance |
-5 |
PROPCAT_Behavior |
-6 |
PROPCAT_Data |
-7 |
PROPCAT_List |
-8 |
PROPCAT_Text |
-9 |
PROPCAT_Scale |
-10 |
PROPCAT_DDE |
-11 |