numberFormat

指定 IPropertyDescription::FormatForDisplay 应如何将属性的值格式化为字符串。 仅当 displayInfo displayType=“Number”>时<,这才适用。 每个 displayInfo 元素应只有一个 numberFormat 元素。

如果有多个元素,则使用最后一个元素。 如果未提供 numberFormat 元素,则默认属性设置将应用于属性说明。

语法

      <!-- numberFormat -->
      <xs:element name="numberFormat"  minOccurs="0" maxOccurs="1">
        <xs:complexType>
          <xs:attribute name="formatAs">
            <xs:simpleType>
              <xs:restriction base="xs:string">
                <xs:enumeration value="General"/>
                <xs:enumeration value="Percentage"/>
                <xs:enumeration value="ByteSize"/>
                <xs:enumeration value="KBSize"/>
                <xs:enumeration value="SampleSize"/>
                <xs:enumeration value="Bitrate"/>
                <xs:enumeration value="SampleRate"/>
                <xs:enumeration value="FrameRate"/>
                <xs:enumeration value="Pixels"/>
                <xs:enumeration value="DPI"/>
                <xs:enumeration value="Duration"/>
              </xs:restriction>
            </xs:simpleType>
          </xs:attribute>
          <xs:attribute name="formatDurationAs">
              <xs:restriction base="xs:string">
                <xs:enumeration value="hh:mm"/>
                <xs:enumeration value="hh:mm:ss"/>
                <xs:enumeration value="hh:mm:ss.fff"/>
              </xs:restriction>
            </xs:simpleType>
          </xs:attribute>
        </xs:complexType>
      </xs:element>

元素信息

父元素 子元素
displayInfo

 

属性

属性 说明
formatAs Public。 可选。 默认值为“常规”。 指定显示格式。 下面是有效的值。
含义
常规 默认。 将值显示为无格式数字。
百分比 将值的格式设置为百分比。 要求 属性为 UInt32。
ByteSize 根据需要将值格式化为字节、“KB”、“MB”或“GB”。 要求 属性为 UInt64。
KBSize 将值格式化为“KB”,无论该值是什么。 要求 属性为 UInt64。
SampleSize 将值的格式设置为位数。 要求 属性为 UInt32。
比特率 以“Kbps”格式设置值的格式。 要求 属性为 UInt32。 该值必须以“每秒位数”单位存储。
SampleRate 以“KHz”格式设置值的格式。 要求 属性为 UInt32。 该值必须以“Hertz”单位存储。
FrameRate 设置值的格式(以帧/秒为单位)。 要求 属性为 UInt32。 该值必须以“千帧/秒”单位存储。
像素 以像素为单位设置值的格式。 要求 属性为 UInt32。
DPI 设置值的格式(以每英寸点为单位)。 要求 属性为 UInt32。
持续时间 将值的格式设置为持续时间。 使用 <formatDurationAs> 指定持续时间格式。 要求 属性为 UInt64。

 

formatDurationAs Public。 可选。 默认值为“hh:mm:ss”。 仅当 formatAs=“Duration”时适用。 要求 属性为 UInt64。 下面是有效的值。
含义
hh:mm 设置值的格式(以小时和分钟为单位)。
hh:mm:ss 默认。 以小时、分钟和秒为单位设置值的格式。
hh:mm:ss.fff 以小时、分钟、秒和毫秒为单位设置值的格式。