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。
Duration 将值的格式设置为持续时间。 使用 <formatDurationAs> 指定持续时间格式。 要求属性为 UInt64。

 

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