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 Общедоступный. Необязательный элемент. Значение по умолчанию — "Общие". Задает формат отображения. Допустимы следующие значения.
Значение Значение
Общие сведения По умолчанию. Отображает значение в виде неформатированного числа.
Процент Форматирует значение в процентах. Требует, чтобы свойство было UInt32.
ByteSize Форматирует значение в виде байтов, "КБ", "МБ" или "ГБ" соответствующим образом. Требует, чтобы свойство было UInt64.
KBSize Форматирует значение как "КБ", независимо от его значения. Требует, чтобы свойство было UInt64.
SampleSize Форматирует значение в виде числа битов. Требует, чтобы свойство было UInt32.
Скорость Форматирует значение в "Кбит/с". Требует, чтобы свойство было UInt32. Значение должно храниться в единицах "бит в секунду".
SampleRate Форматирует значение в "KHz". Требует, чтобы свойство было UInt32. Значение должно храниться в единицах "Герц".
FrameRate Форматирует значение в кадрах в секунду. Требует, чтобы свойство было UInt32. Значение должно храниться в единицах "кило кадров в секунду".
Перекрытых Форматирует значение в пикселях. Требует, чтобы свойство было UInt32.
DPI Форматирует значение в точках на дюйм. Требует, чтобы свойство было UInt32.
Duration Форматирует значение в виде длительности. Используйте <formatDurationAs> , чтобы указать формат длительности. Требует, чтобы свойство было UInt64.

 
formatDurationAs Общедоступный. Необязательный элемент. Значение по умолчанию — "чч:мм:сс". Применяется, только если formatAs="Duration". Требует, чтобы свойство было UInt64. Допустимы следующие значения.
Значение Значение
чч:мм Форматирует значение в часах и минутах.
чч:мм:сс По умолчанию. Форматирует значение в часах, минутах и секундах.
чч:мм:сс.fff Форматирует значение в часах, минутах, секундах и миллисекундах.