Typeinfo

Gibt die Typinformationen einer Eigenschaft an. Für jede eigenschaftDescription sollte nur ein typeInfo-Element vorhanden sein. Dieses Element wurde für Windows 7 geändert.

Wenn mehrere Elemente vorhanden sind, wird das letzte Element verwendet. Wenn kein typeInfo-Element angegeben wird, werden die Standardattributeeinstellungen auf die Eigenschaftenbeschreibung angewendet.

Syntax für Windows 7

<!-- typeInfo for Windows 7-->
<xs:element name="typeInfo">
    <xs:complexType>
        <xs:attribute name="type" default="Any">
            <xs:simpleType>
                <xs:restriction base="xs:string">
                    <xs:enumeration value="Any"/>
                    <xs:enumeration value="Null"/>
                    <xs:enumeration value="String"/>
                    <xs:enumeration value="Boolean"/>
                    <xs:enumeration value="Byte"/>
                    <xs:enumeration value="Buffer"/>
                    <xs:enumeration value="Int16"/>
                    <xs:enumeration value="UInt16"/>
                    <xs:enumeration value="Int32"/>
                    <xs:enumeration value="UInt32"/>
                    <xs:enumeration value="Int64"/>
                    <xs:enumeration value="UInt64"/>
                    <xs:enumeration value="Double"/>
                    <xs:enumeration value="DateTime"/>
                    <xs:enumeration value="Guid"/>
                    <xs:enumeration value="Blob"/>
                    <xs:enumeration value="Stream"/>
                    <xs:enumeration value="Clipboard"/>
                    <xs:enumeration value="Object"/>
                </xs:restriction>
            </xs:simpleType>
        </xs:attribute>
        <xs:attribute name="groupingRange">
            <xs:simpleType>
                <xs:restriction base="xs:string">
                    <xs:enumeration value="Discrete"/>
                    <xs:enumeration value="Alphanumeric"/>
                    <xs:enumeration value="Size"/>
                    <xs:enumeration value="Date"/>
                    <xs:enumeration value="Dynamic"/>
                    <xs:enumeration value="Percent"/>
                    <xs:enumeration value="Enumerated"/>
                </xs:restriction>
            </xs:simpleType>
        </xs:attribute>
        <xs:attribute name="isInnate" type="xs:boolean" default="false"/>
        <xs:attribute name="canBePurged" type="xs:boolean"/>
        <xs:attribute name="multipleValues" type="xs:boolean" default="false"/>
        <xs:attribute name="isGroup" type="xs:boolean" default="false"/>
        <xs:attribute name="aggregationType">
            <xs:simpleType>
                <xs:restriction base="xs:string">
                    <xs:enumeration value="Default"/>
                    <xs:enumeration value="First"/>
                    <xs:enumeration value="Sum"/>
                    <xs:enumeration value="Average"/>
                    <xs:enumeration value="DateRange"/>
                    <xs:enumeration value="Union"/>
                    <xs:enumeration value="Maximum"/>
                    <xs:enumeration value="Minimum"/>
                </xs:restriction>
            </xs:simpleType>
        </xs:attribute>
        <xs:attribute name="isTreeProperty" type="xs:boolean" default="false"/>
        <xs:attribute name="isViewable" type="xs:boolean" default="false"/>
        <xs:attribute name="isQueryable" type="xs:boolean" default="false"/>
        <xs:attribute name="includeInFullTextQuery" type="xs:boolean" default="false"/>
        <xs:attribute name="searchRawValue" type="xs:boolean" default="false"/>
        <xs:attribute name="conditionType">
            <xs:simpleType>
                <xs:restriction base="xs:string">
                    <xs:enumeration value="None"/>
                    <xs:enumeration value="String"/>
                    <xs:enumeration value="Number"/>
                    <xs:enumeration value="DateTime"/>
                    <xs:enumeration value="Boolean"/>
                    <xs:enumeration value="Size"/>
                </xs:restriction>
            </xs:simpleType>
        </xs:attribute>
        <xs:attribute name="defaultOperation">
            <xs:simpleType>
                <xs:restriction base="xs:string">
                    <xs:enumeration value="Equal"/>
                    <xs:enumeration value="NotEqual"/>
                    <xs:enumeration value="LessThan"/>
                    <xs:enumeration value="GreaterThan"/>
                    <xs:enumeration value="Contains"/>
                </xs:restriction>
            </xs:simpleType>
        </xs:attribute>
    </xs:complexType>
</xs:element>

Elementinformationen

Übergeordnetes Element Untergeordnete Elemente
propertyDescription Keine

 

Attribute

attribute BESCHREIBUNG
type Öffentlich. Optional. Der Standardwert ist "Any". Gibt den Typ der Eigenschaft an. Im Folgenden sind gültige Typen und die zugehörigen Variantentypen werden von IPropertyDescription::GetPropertyType abgerufen.
Wert Bedeutung
Any Standard. Das Eigenschaftssubsystem erzwingt oder erzwungen den Eigenschaftswert nicht. IPropertyDescription::GetPropertyType gibt VT_NULL zurück. Unabhängige Softwareanbieter (Independent Software Vendors, ISVs) werden dringend empfohlen, einen Typ bereitzustellen, anstatt auf diesen Standardwert zurückzugreifen.
Null Für diese Eigenschaft gibt es keinen Wert. IPropertyDescription::GetPropertyType gibt VT_NULL zurück.
String Der Wert muss ein VT_LPWSTR sein, wobei es sich um eine Unicode-Zeichenfolge handelt, die durch einen NULL-Verweis beendet wird.
Boolean Der Wert muss ein VT_BOOL sein, bei dem es sich um einen booleschen Wert handelt.
Byte Der Wert muss ein VT_UI1 sein, bei dem es sich um ein Byte handelt.
Buffer Der Wert muss ein VT_UI1 | VT_VECTOR Puffer von Bytes.
Int16 Der Wert muss ein VT_I2 sein, bei dem es sich um eine ganze 16-Bit-Zahl handelt.
UInt16 Der Wert muss eine VT_UI2 sein, bei der es sich um eine 16-Bit-Ganzzahl ohne Vorzeichen handelt.
Int32 Der Wert muss ein VT_I4 sein, bei dem es sich um eine 32-Bit-Ganzzahl handelt.
UInt32 Der Wert muss eine VT_UI4 sein, bei der es sich um eine 32-Bit-Ganzzahl ohne Vorzeichen handelt.
Int64 Der Wert muss ein VT_I8 sein, bei dem es sich um eine ganze 64-Bit-Zahl handelt.
UInt64 Der Wert muss ein VT_UI8 sein, bei dem es sich um eine 64-Bit-Ganzzahl ohne Vorzeichen handelt.
Double Der Wert muss ein VT_R8 sein, bei dem es sich um ein Double handelt.
Datetime Der Wert muss ein VT_FILETIME sein, bei dem es sich um einen FILETIME-Wert handelt.
Guid Der Wert muss ein VT_CLSID sein, bei dem es sich um einen Klassenbezeichner (CLSID) handelt.
Blob Der Wert muss ein VT_BLOB sein, bei dem es sich um Bytes mit Längenpräfix handelt.
STREAM Der Wert muss ein VT_STREAM sein, bei dem es sich um ein Objekt handelt, das IStream implementiert.
Zwischenablage Der Wert muss ein VT_CF sein, bei dem es sich um ein Zwischenablageformat handelt.
Object Der Wert muss ein VT_UNKNOWN sein, bei dem es sich um ein Objekt handelt, das IUnknown implementiert.

 

groupingRange Optional. Der Standardwert ist "Diskret". Gibt an, wie die Eigenschaft angezeigt wird, wenn eine Ansicht nach dieser Eigenschaft gruppiert wird. Nach dem Festlegen werden diese Werte von IPropertyDescription::GetGroupingRange abgerufen. Im Folgenden sind gültige Typen aufgeführt.
Wert Bedeutung
Discrete Standard. Zeigt einzelne Werte an.
Alphanumerisch Zeigt statische alphanumerische Bereiche für Werte an.
Size Zeigt statische Größenbereiche für Werte an.
Date Zeigt Monats-/Jahresgruppen an. Standard für Eigenschaften vom Typ="DateTime".
TimeRelative Wird in zeitrelativen Gruppen angezeigt.
Dynamisch Zeigt dynamisch erstellte Bereiche für die Werte an.
Percent Zeigt Prozent-Buckets an.

 

isInnate Öffentlich. Optional. Der Standardwert ist „false“. Gibt an, ob die Eigenschaft als angeboren gilt. Eine angeborene Eigenschaft ist eine Eigenschaft, die entweder aus dem Inhalt einer Datei oder aus anderen Ressourcen oder Systemen berechnet wird. System.Size ist beispielsweise eine angeborene Eigenschaft, die vom Dateisystem bereitgestellt wird. Das Ändern des Werts der Eigenschaft an sich bringt nichts. Weitere Beispiele sind System.Image.Dimensions und System.Document.PageCount, die von Programmen basierend auf dem Inhalt der Datei berechnet werden, nicht basierend auf einer benutzerveränderlichen Einstellung. Die Einstellung isInnate="true" bedeutet, dass der Benutzer diese Eigenschaft nicht direkt über ein Eigenschaftensteuerelement bearbeiten kann. Dieser Wert entspricht dem flag PDTF_ISINNATE, das in PROPDESC_TYPE_FLAGS definiert und in IPropertyDescription::GetTypeFlags verwendet wird.
canBePurged Nur Windows Vista mit Service Pack 1 (SP1) und höher. Öffentlich. Optional. Wenn dieser Wert auf "true" festgelegt ist, kann eine angeborene Eigenschaft gelöscht werden. Angeborene Eigenschaften, die aus anderen Eigenschaften berechnet werden, sind per Definition schreibgeschützt. Der Standardwert für dieses Attribut hängt vom isInnate-Wert ab.
isInnate canBePurged-Standardwert
true false
false true

 

Hinweis:
Eine Eigenschaft, deren isInnate-Wert "false" ist (d. h., dass die Eigenschaft Lese-/Schreibzugriff hat), kann den canBePurged-Wert nicht auch auf "false" festlegen. Diese Einschränkung wird vom Betriebssystem erzwungen.

 

Obwohl dieses Attribut in Windows Vista mit Service Pack 1 (SP1) eingeführt wurde, ist eine PROPDESC-Datei, die dieses Attribut enthält, mit Windows Vista vor Windows Vista mit SP1 kompatibel. Das canBePurged-Attribut wird in dieser Situation einfach ignoriert.

multipleValues Öffentlich. Optional. Der Standardwert ist „false“. Gibt an, ob diese Eigenschaft mehrere Werte haben kann. Dieser Wert entspricht dem flag PDTF_MULTIPLEVALUES, das in PROPDESC_TYPE_FLAGS definiert und in IPropertyDescription::GetTypeFlags verwendet wird. Dies beeinflusst auch, ob VT_VECTOR für den VARTYPE des Eigenschaftswerts OR'd ist.
isGroup Öffentlich. Optional. Der Standardwert ist „false“. Gibt an, ob die Eigenschaft eine Gruppenüberschrift ist. Eine Gruppenüberschrift wird in Proplists streng verwendet, hat keinen Wert, wird nie in einer Datei gespeichert und sollte auch typeInfo type="Null"> aufweisen<. Einige Benutzeroberfläche im System verwenden Proplists, um die Reihenfolge der anzuzeigenden Eigenschaften anzugeben. Diese Proplists können Verweise auf Gruppenüberschriften (z. B. System.PropGroup.Camera) enthalten, die die Benutzeroberfläche anweisen, einen neuen Gruppenabschnitt zu starten (z. B. "Kameraeinstellungen"). Eine Eigenschaftenbeschreibung mit isGroup="true" sollte ein <labelInfo label="Some localized label"> angeben, andernfalls ist es keine nützliche Eigenschaft. Dieser Wert entspricht dem PDTF_ISGROUP Flag, das in PROPDESC_TYPE_FLAGS definiert und in IPropertyDescription::GetTypeFlags verwendet wird.
aggregationType Öffentlich. Optional. Der Standardwert ist "Default". Gibt an, wie Aggregateigenschaften angezeigt werden, wenn mehrere Elemente ausgewählt werden. Nach dem Festlegen werden diese Werte von IPropertyDescription::GetAggregationType als PROPDESC_AGGREGATION_TYPE abgerufen. Im Folgenden sind gültige Typen aufgeführt.
Wert Bedeutung
Standard Standard. Zeigt einen Platzhalter mit mehreren Werten auf der Benutzeroberfläche an. Dies ist die Standardeinstellung, wenn der Typ mit dem angegebenen aggregationType nicht kompatibel ist.
First Zeigt den Eigenschaftswert des ersten Elements in der Auswahl oder Auflistung an.
Sum Zeigt die Summe der numerischen Werte an. Nützlich für Eigenschaften wie System.Media.Duration oder System.Size. Dieser Wert ist mit nicht numerischen Typen nicht kompatibel.
Average Zeigt den Durchschnitt der numerischen Werte an. Nützlich für Eigenschaften wie System.Rating. Dieser Wert ist mit nicht numerischen Typen nicht kompatibel.
DateRange Zeigt einen Datumsbereich an. Nützlich für Eigenschaften wie System.Photo.DateTaken. Dieser Wert ist mit nichts außer type="DateTime" kompatibel und ist die Standardeinstellung für Eigenschaften dieses Typs.
Union Zeigt eine Vereinigung aller Werte in der Auswahl oder Auflistung an. Die Reihenfolge, in der die Werte angezeigt werden, ist undefiniert. Dieser Wert ist der Standardwert für Die Eigenschaften type="String" und multipleValues="true".
Maximum Zeigt den Maximalwert in der Auflistung an. Nützlich für Eigenschaften wie System.DateModified. Nicht kompatibel mit nicht numerischen oder nicht datumsbasierten Typen.
Minimum Zeigt den Mindestwert in der Auflistung an. Nicht kompatibel mit nicht numerischen oder nicht datumsbasierten Typen.

 

isTreeProperty Öffentlich. Optional. Der Standardwert ist "false".
isViewable Öffentlich. Optional. Der Standardwert ist "false". Gibt an, ob diese Eigenschaft für den Benutzer sichtbar sein soll. Auf der Benutzeroberfläche der Spaltenwählung werden beispielsweise nur die Eigenschaften angezeigt, die isViewable="true" aufweisen. Die Ausnahme ist die Benutzeroberfläche, die von einer Proplist gesteuert wird, die immer die -Eigenschaft anzeigt. Wenn Sie über eine Eigenschaft verfügen, die nur dazu bestimmt ist, Daten zwischen zwei Objekten zu übertragen und niemals vom Benutzer angezeigt zu werden, sollte dieses Attribut false sein. Dieser Wert entspricht dem PDTF_ISVIEWABLE Flag, das in PROPDESC_TYPE_FLAGS definiert und in IPropertyDescription::GetTypeFlags verwendet wird.
isQueryable Nur Windows Vista. Wird in Windows 7 und höher nicht unterstützt. Öffentlich. Optional. Der Standardwert ist "false". Gibt an, ob diese Eigenschaft auf der Benutzeroberfläche des Suchabfrage-Generators verfügbar sein soll. Eine Eigenschaft muss über isViewable="true" verfügen, bevor isQueryable="true" berücksichtigt wird. Dieser Wert entspricht dem in PROPDESC_TYPE_FLAGS definierten und in IPropertyDescription::GetTypeFlags verwendeten PDTF_ISQUERYABLE-Flag.
searchRawValue Windows 7 und höher. Öffentlich. Optional. Der Standardwert ist "false".
includeInFullTextQuery Nur Windows Vista. Wird in Windows 7 und höher nicht unterstützt. Öffentlich. Optional. Der Standardwert ist "false".
conditionType Öffentlich. Optional. Der Standardwert ist "String". Gibt einen Hinweis auf die Benutzeroberfläche des Suchabfrage-Generators an, damit die Liste der möglichen Bedingungsoperatoren innerhalb eines Prädikats bestimmt werden kann. Die folgenden Werte werden erkannt.
Wert Bedeutung
String Standard. Die folgenden Operatoren werden verwendet: "is", "is not", "<", ">", "<=", ">=", "starts with", "ends with", "contains", "does't contains", "is like".
Number Standard für numerische Eigenschaften. Die folgenden Operatoren werden verwendet: "gleich", "nicht gleich", "ist kleiner als", "ist größer als", "ist kleiner als oder gleich", "ist größer als oder gleich", "ist größer als oder gleich".
Datetime Standard für Eigenschaften vom Typ="DateTime". Die folgenden Operatoren werden verwendet: "is", "is not", "is before", "is after", "is before but includes", "is after but includes", "is after but includes".
Boolean Standard für Eigenschaften vom Typ="Boolean". Identisch mit Zahl.
Size Identisch mit Zahl.

 

defaultOperation Öffentlich. Optional. Der Standardwert ist "Gleich". Gibt einen Hinweis für das Tool Suchabfrage-Generator an, damit es den Standardoperator bestimmen kann. Die folgenden Werte sind möglich:
Wert Bedeutung
Equal Standard. Gibt eine entsprechung an.
NotEqual Gibt nicht gleichwertig an.
LessThan Gibt kleiner als an.
GreaterThan Standard für Eigenschaften von conditionType="Size". Gibt größer als an.
Enthält Standardwert für Eigenschaften von conditionType="String". Gibt die Aufnahme an.