numberFormat

  • Articolo

Specifica il modo in cui IPropertyDescription::FormatForDisplay deve formattare il valore della proprietà come stringa. Questa opzione è applicabile solo se <displayInfo displayType="Number">. Per ogni elemento displayInfo deve essere presente un solo elemento numberFormat.

Se sono presenti più elementi, viene usata l'ultima. Se non viene specificato alcun elemento numberFormat , le impostazioni predefinite dell'attributo vengono applicate alla descrizione della proprietà.

Sintassi

      <!-- 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>

Informazioni sull'elemento

Elemento padre Elementi figlio
displayInfo Nessuno

 

Attributi

Attributo Descrizione
formatAs Pubblica. Facoltativa. Il valore predefinito è "General". Specifica il formato di visualizzazione. I valori validi sono i seguenti.
Valore Significato
Generale Valore predefinito. Visualizza il valore come numero non formattato.
Percentuale Formatta il valore come percentuale. Richiede che la proprietà sia UInt32.
ByteSize Formatta il valore come byte, "KB", "MB" o "GB" in base alle esigenze. Richiede che la proprietà sia UInt64.
KBSize Formatta il valore come "KB", indipendentemente dal valore. Richiede che la proprietà sia UInt64.
SampleSize Formatta il valore come numero di bit. Richiede che la proprietà sia UInt32.
Velocità in bit Formatta il valore in "Kbps". Richiede che la proprietà sia UInt32. Il valore deve essere archiviato in unità "bit al secondo".
SampleRate Formatta il valore in "KHz". Richiede che la proprietà sia UInt32. Il valore deve essere archiviato in unità "Hz".
FrameRate Formatta il valore in frame al secondo. Richiede che la proprietà sia UInt32. Il valore deve essere archiviato in unità "kilo-frame-al secondo".
Pixel Formatta il valore in unità pixel. Richiede che la proprietà sia UInt32.
DPI Formatta il valore in punti per pollice. Richiede che la proprietà sia UInt32.
Durata Formatta il valore come durata. Usare <formatDurationAs> per specificare il formato di durata. Richiede che la proprietà sia UInt64.

 
formatDurationAs Pubblica. Facoltativa. Il valore predefinito è "hh:mm:ss". Si applica solo se formatAs="Duration". Richiede che la proprietà sia UInt64. I valori validi sono i seguenti.
Valore Significato
hh:mm Formatta il valore in ore e minuti.
hh:mm:ss Valore predefinito. Formatta il valore in ore, minuti e secondi.
hh:mm:ss.fff Formatta il valore in ore, minuti, secondi e millisecondi.