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>

元素信息

Parent 元素 子元素
displayInfo 没有

 

属性

属性 描述
formatAs 公共。 自选。 默认值为“常规”。 指定显示格式。 以下是有效值。
价值 意义
常规 违约。 将值显示为未格式化的数字。
百分比 将值的格式设置为百分比。 要求属性为 UInt32。
ByteSize 根据需要将值格式化为字节、“KB”、“MB”或“GB”。 要求属性为 UInt64。
KBSize 将值格式化为“KB”,无论值是什么。 要求属性为 UInt64。
SampleSize 将值格式化为多个位。 要求属性为 UInt32。
BitRate 在“Kbps”中设置值的格式。 要求属性为 UInt32。 该值必须存储在“每秒位数”单位中。
SampleRate 在“KHz”中设置值的格式。 要求属性为 UInt32。 该值必须存储在“Hertz”单位中。
FrameRate 设置帧/秒中的值的格式。 要求属性为 UInt32。 该值必须存储在“千帧/秒”单位中。
像素 以像素单位格式设置值的格式。 要求属性为 UInt32。
DPI 以点/英寸格式设置值的格式。 要求属性为 UInt32。
期间 将值的格式设置为持续时间。 使用 <formatDurationAs> 指定持续时间格式。 要求属性为 UInt64。

 

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