displayInfo

Artykuł
2025-03-12

Określa informacje o wyświetlaniu właściwości. Powinien istnieć tylko jeden element displayInfo dla każdego propertyDescription.

Jeśli istnieje wiele elementów, zostanie użyty ostatni element. Jeśli nie podano elementu displayInfo, domyślne ustawienia atrybutu są stosowane do opisu właściwości.

Składnia

<!-- displayInfo -->
<xs:element name="displayInfo">
    <xs:complexType>
        <xs:all>
            <xs:element name="stringFormat" minOccurs="0" maxOccurs="1">
                <xs:complexType>
                    <xs:attribute name="formatAs">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:enumeration value="General"/>
                                <xs:enumeration value="FileName"/>
                                <xs:enumeration value="FilePath"/>
                                <xs:enumeration value="Hyperlink"/>
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:complexType>
            </xs:element>
            <xs:element name="booleanFormat" minOccurs="0" maxOccurs="1">
                <xs:complexType>
                    <xs:attribute name="formatAs">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:enumeration value="YesNo"/>
                                <xs:enumeration value="OnOff"/>
                                <xs:enumeration value="TrueFalse"/>
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:complexType>
            </xs:element>
            <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:simpleType>
                            <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>
            <xs:element name="dateTimeFormat" minOccurs="0" maxOccurs="1">
                <xs:complexType>
                    <xs:attribute name="formatAs">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:enumeration value="General"/>
                                <xs:enumeration value="Month"/>
                                <xs:enumeration value="YearMonth"/>
                                <xs:enumeration value="Year"/>
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                    <xs:attribute name="formatTimeAs">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:enumeration value="ShortTime"/>
                                <xs:enumeration value="LongTime"/>
                                <xs:enumeration value="HideTime"/>
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                    <xs:attribute name="formatDateAs">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:enumeration value="ShortDate"/>
                                <xs:enumeration value="LongDate"/>
                                <xs:enumeration value="HideDate"/>
                                <xs:enumeration value="RelativeShortDate"/>
                                <xs:enumeration value="RelativeLongDate"/>
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:complexType>
            </xs:element>
            <xs:element name="enumeratedList" minOccurs="0" maxOccurs="1">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="enum" minOccurs="0" maxOccurs="unbounded">
                            <xs:complexType>
                                <xs:attribute name="value" type="xs:string" use="required"/>
                                <xs:attribute name="text" type="xs:string" use="required"/>
                            </xs:complexType>
                        </xs:element>
                        <xs:element name="enumRange" minOccurs="0" maxOccurs="unbounded">
                            <xs:complexType>
                                <xs:attribute name="minValue" type="xs:string" use="required"/>
                                <xs:attribute name="setValue" type="xs:string"/>
                                <xs:attribute name="text" type="xs:string"/>
                            </xs:complexType>
                        </xs:element>
                    </xs:sequence>

                    <xs:attribute name="defaultText" type="xs:string"/>
                    <xs:attribute name="useValueForDefault" type="xs:boolean"/>
                </xs:complexType>
            </xs:element>
            <xs:element name="drawControl" minOccurs="0" maxOccurs="1">
                <xs:complexType>
                    <xs:attribute name="control">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:enumeration value="Default"/>
                                <xs:enumeration value="MultiLineText"/>
                                <xs:enumeration value="MultiValueText"/>
                                <xs:enumeration value="PercentBar"/>
                                <xs:enumeration value="ProgressBar"/>
                                <xs:enumeration value="Rating"/>
                                <xs:enumeration value="StaticText"/>
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:complexType>
            </xs:element>
            <xs:element name="editControl" minOccurs="0" maxOccurs="1">
                <xs:complexType>
                    <xs:attribute name="control">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:enumeration value="Default"/>
                                <xs:enumeration value="Calendar"/>
                                <xs:enumeration value="CheckboxDropList"/>
                                <xs:enumeration value="DropList"/>
                                <xs:enumeration value="MultiLineText"/>
                                <xs:enumeration value="MultiValueText"/>
                                <xs:enumeration value="Rating"/>
                                <xs:enumeration value="Text"/>
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:complexType>
            </xs:element>
            <xs:element name="filterControl" minOccurs="0" maxOccurs="1">
                <xs:complexType>
                    <xs:attribute name="control">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:enumeration value="Default"/>
                                <xs:enumeration value="Calendar"/>
                                <xs:enumeration value="Rating"/>
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:complexType>
            </xs:element>
            <xs:element name="queryControl" minOccurs="0" maxOccurs="1">
                <xs:complexType>
                    <xs:attribute name="control">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:enumeration value="Default"/>
                                <xs:enumeration value="Boolean"/>
                                <xs:enumeration value="Calendar"/>
                                <xs:enumeration value="CheckboxDropList"/>
                                <xs:enumeration value="DropList"/>
                                <xs:enumeration value="MultiValueText"/>
                                <xs:enumeration value="NumericText"/>
                                <xs:enumeration value="Rating"/>
                                <xs:enumeration value="Text"/>
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:complexType>
            </xs:element>
        </xs:all>

        <xs:attribute name="defaultColumnWidth" type="xs:nonNegativeInteger" default="20"/>
        <xs:attribute name="displayType">
            <xs:simpleType>
                <xs:restriction base="xs:string">
                    <xs:enumeration value="String"/>
                    <xs:enumeration value="Number"/>
                    <xs:enumeration value="Boolean"/>
                    <xs:enumeration value="DateTime"/>
                    <xs:enumeration value="Enumerated"/>
                </xs:restriction>
            </xs:simpleType>
        </xs:attribute>
        
        <xs:attribute name="alignment" default="Left">
            <xs:simpleType>
                <xs:restriction base="xs:string">
                    <xs:enumeration value="Left"/>
                    <xs:enumeration value="Center"/>
                    <xs:enumeration value="Right"/>
                </xs:restriction>
            </xs:simpleType>
        </xs:attribute>
        <xs:attribute name="relativeDescriptionType">
            <xs:simpleType>
                <xs:restriction base="xs:string">
                    <xs:enumeration value="General"/>
                    <xs:enumeration value="Date"/>
                    <xs:enumeration value="Size"/>
                    <xs:enumeration value="Count"/>
                    <xs:enumeration value="Revision"/>
                    <xs:enumeration value="Length"/>
                    <xs:enumeration value="Duration"/>
                    <xs:enumeration value="Speed"/>
                    <xs:enumeration value="Rate"/>
                    <xs:enumeration value="Rating"/>
                    <xs:enumeration value="Priority"/>
                </xs:restriction>
            </xs:simpleType>
        </xs:attribute>
        <xs:attribute name="defaultSortDirection" default="Ascending">
            <xs:simpleType>
                <xs:restriction base="xs:string">
                  <xs:enumeration value="Ascending"/>
                  <xs:enumeration value="Descending"/>
                </xs:restriction>
            </xs:simpleType>
        </xs:attribute>
    </xs:complexType>
</xs:element>

Informacje o elementach

Element nadrzędny	Elementy podrzędne
propertyDescription	stringFormat
	wartość logicznaFormat
	numberFormat
	dateTimeFormat
	wyliczanalista
	drawControl
	editControl
	filterControl
	queryControl (tylko system Windows Vista). Nieobsługiwane w systemie Windows 7 lub nowszym).

Atrybuty

defaultColumnWidth

Publiczny. Fakultatywny. Wartość domyślna to "20".

displayType

Publiczny. Fakultatywny. Wartość domyślna to "Ciąg". Określa typ ciągu wyświetlania. Po ustawieniu tutaj skojarzone wartości PROPDESC_DISPLAYTYPE są pobierane przez IPropertyDescription::GetDisplayType. Poniżej przedstawiono prawidłowe typy.

Wartość	Znaczenie
Struna	Domyślny. Wartość jest wyświetlana jako ciąg. Użyj ciąguFormat, aby sformatować. Metoda zwraca PDDT_STRING.
Numer	Wartość domyślna dla właściwości liczbowych. Wartość jest wyświetlana jako liczba. Użyj formatu "numberFormat", aby sformatować. Metoda zwraca PDDT_NUMBER.
Boolowski	Ustawienie domyślne, jeśli <typeInfo type="Wartość logiczna">. Wartość jest wyświetlana jako wartość logiczna. Użyj wartości "booleanFormat", aby sformatować. Metoda zwraca PDDT_BOOLEAN.
Data/godzina	Ustawienie domyślne, jeśli <typeInfo type="DateTime">. Wartość jest wyświetlana jako data lub godzina. Użyj wartości "dateTimeFormat", aby sformatować. Metoda zwraca PDDT_DATETIME.
Wyliczenie	Wartość jest wyświetlana jako mapowanie ciągów wyświetlanych dostarczonych przez element "enumeratedList". Metoda zwraca PDDT_ENUMERATED.

wyrównanie

Fakultatywny. Wartość domyślna to "Left".

Wartość	Znaczenie
Lewy	Domyślny. Wyrównaj do lewej.
Centrum	Wyrównaj do środka.
Prawy	Wyrównaj do prawej.

relativeDescriptionType

Fakultatywny. Wartość domyślna to "Ogólne". Określa, w jaki sposób należy opisać dwie wartości tej właściwości podczas ich porównywania ze sobą. W przypadku równoważności zawsze jest używana wartość "Taka sama". IPropertyDescription::GetRelativeDescription i IPropertyDescription::GetRelativeDescriptionType użyć tej wartości, aby określić, jakich nazw wyświetlanych opisów względnych używać.

Wartość	Znaczenie
Ogólne	Domyślny. Używa "Różne" / "Same" / "Różne".
Data	Ustawienie domyślne, jeśli <typeInfo type="DateTime">. Używa "Wcześniejsze" / "Same" / "Later" lub używa "Starsze" / "Same" / "Nowsze" lub używa "Sooner" / "Same" / "Later".
Rozmiar	Używa "Mniejszy" / "Ten sam" / "Większy"
Hrabia	Używa "Mniejszy" / "Ten sam" / "Większy"
Rewizja	Używa "Wcześniejsze" / "Same" / "Later"
Długość	Używa "Krótszego" / "Same" / "Longer"
Czas trwania	Używa "Krótszego" / "Same" / "Longer"
Szybkość	Używa "Wolniejsze" / "Same" / "Szybsze"
Tempo	Używa "Wolniejsze" / "Same" / "Szybsze"
Ocena	Używa wartości "Lower" / "Same" / "Higher"
Priorytet	Używa wartości "Lower" / "Same" / "Higher"

defaultSortDirection

Określa kierunek sortowania. Wartość domyślna to "Rosnąco".

Wartość	Znaczenie
Rosnąco	Sortuje rosnąco.
Malejąco	Sortuje malejąco.

Udostępnij za pośrednictwem

displayInfo

Składnia

Informacje o elementach

Atrybuty

Opinia

Dodatkowe zasoby