Tells whether a property definition is visible for an attribute.

    bool  ACAPI_Attribute_IsPropertyDefinitionVisible (        
        const API_Attr_Head&      attrHead,
        const API_Guid&           propertyGuid
    );

 

Parameters

attrHead

[in] Header of the attribute. The attribute is identified by typeID and index

propertyGuid

[in] The property definition GUID to search for.

 

Return Values

true

The given property definition is visible for the attribute.

false

The given property definition is not visible for the attribute or invalid parameters.

Example

GSErrCode GetVisiblePropertyDefinitions (API_AttrTypeID attributeTypeID, short attributeIndex, GS::Array<API_PropertyDefinition>& visibleProperties)
{
    GS::Array<API_PropertyDefinition> definitions;
    API_Attr_Head                     attributeHeader;

    BNZeroMemory (&attributeHeader, sizeof (API_Attr_Head));
    attributeHeader.typeID = attributeTypeID;
    attributeHeader.index = attributeIndex;

    GSErrCode error = ACAPI_Property_GetPropertyDefinitions (APINULLGuid, definitions);
    if (error == NoError) {
        for (UInt32 i = 0; i < definitions.GetSize (); ++i) {
            if (ACAPI_Attribute_IsPropertyDefinitionVisible (attributeHeader, definitions[i].guid)) {
                visibleProperties.Push (definitions[i]);
            }
        }
    }
    return error;
}
        

For more detailed examples, please see the Property_Test add-on.

 

Requirements

Version: [Not yet released]

Header: ACAPinc.h

 

See Also

Properties, Classification and Property Visibility