propertyDescription

描述单个唯一的规范属性。 每个预期在系统中可用的此类属性都必须具有相应的 propertyDescription 元素。

Windows 7 的语法

<!-- propertyDescription for Windows 7-->
<xs:element name="propertyDescription">
    <xs:complexType>
        <xs:all>
            <xs:element ref="searchInfo"          minOccurs="0" maxOccurs="1"/>
            <xs:element ref="labelInfo"           minOccurs="0" maxOccurs="1"/>
            <xs:element ref="typeInfo"            minOccurs="0" maxOccurs="1"/>
            <xs:element ref="aliasInfo"           minOccurs="0" maxOccurs="1"/>
            <xs:element ref="displayInfo"         minOccurs="0" maxOccurs="1"/>
            <xs:element ref="relatedPropertyInfo" minOccurs="0" maxOccurs="1"/>
        </xs:all>

        <xs:attribute name="formatID"  type="uuid" use="required"/>
        <xs:attribute name="propID"    type="propid" use="required"/>
        <xs:attribute name="name"      type="canonical-name"        use="required"/>
    </xs:complexType>
</xs:element>

Vista 的语法

<!-- propertyDescription for Windows Vista-->
<xs:element name="propertyDescription">
    <xs:complexType>
        <xs:all>
            <xs:element ref="searchInfo"          minOccurs="0" maxOccurs="1"/>
            <xs:element ref="labelInfo"           minOccurs="0" maxOccurs="1"/>
            <xs:element ref="typeInfo"            minOccurs="0" maxOccurs="1"/>
            <xs:element ref="aliasInfo"           minOccurs="0" maxOccurs="1"/>
            <xs:element ref="displayInfo"         minOccurs="0" maxOccurs="1"/>
        </xs:all>

        <xs:attribute name="formatID"  type="uuid" use="required"/>
        <xs:attribute name="propID"    type="xs:nonNegativeInteger" use="required"/>
        <xs:attribute name="name"      type="canonical-name"        use="required"/>
    </xs:complexType>
</xs:element>

元素信息

父元素 子元素
propertyDescriptionList searchInfo
labelInfo
typeInfo
aliasInfo
displayInfo
relatedPropertyInfo

属性

属性 说明
name 必需。 系统唯一的规范属性名称;例如, System.Rating 。 此字符串的类型为规范类型,限制为 64 个字符。 该名称区分大小写,应使用以下语法:Publisher。Application.PropertyName。 IPropertyDescription::GetCanonicalName 返回此值。
formatID 必需。 属性的格式标识符 (FMTID) 。 值必须包含括住大括号;例如, {64440492-4C8B-11D1-8B70-080036B11A03}IPropertyDescription::GetPropertyKey 返回此值。
propID 必需。 属性标识符 (PID) ;例如, 9IPropertyDescription::GetPropertyKey 返回此值。 此值必须大于或等于 2。 值 0 和 1 由系统保留。