typeInfo

Menentukan informasi jenis properti. Seharusnya hanya ada satu elemen typeInfo untuk setiap propertyDescription. Elemen ini telah berubah untuk Windows 7.

Jika ada beberapa elemen, yang terakhir digunakan. Jika tidak ada elemen typeInfo yang disediakan, maka pengaturan atribut default diterapkan ke deskripsi properti.

Sintaks untuk 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>

Informasi Elemen

Elemen Induk Elemen Anak
propertyDescription Tidak ada

 

Atribut

Atribut Deskripsi
jenis Publik. Opsional. Defaultnya adalah "Any". Menunjukkan jenis properti . Berikut ini adalah jenis yang valid dan jenis varian terkait diambil oleh IPropertyDescription::GetPropertyType.
Nilai Makna
Apa pun Default. Subsistem properti tidak akan memberlakukan atau memaksa nilai properti. IPropertyDescription::GetPropertyType mengembalikan VT_NULL. Vendor perangkat lunak independen (ISV) sangat didorong untuk menyediakan jenis daripada mundur pada default ini.
Null Tidak ada nilai untuk properti ini. IPropertyDescription::GetPropertyType mengembalikan VT_NULL.
String Nilai harus berupa VT_LPWSTR, yang merupakan string Unicode yang dihentikan oleh referensi null.
Boolean Nilai harus berupa VT_BOOL, yang merupakan boolean.
Byte Nilai harus berupa VT_UI1, yang merupakan byte.
Buffer Nilai harus berupa VT_UI1 | VT_VECTOR buffer byte.
Int16 Nilai harus berupa VT_I2, yang merupakan bilangan bulat 16-bit.
UInt16 Nilai harus berupa VT_UI2, yang merupakan bilangan bulat yang tidak ditandatangani 16-bit.
Int32 Nilai harus berupa VT_I4, yang merupakan bilangan bulat 32-bit.
UInt32 Nilai harus berupa VT_UI4, yang merupakan bilangan bulat yang tidak ditandatangani 32-bit.
Int64 Nilai harus berupa VT_I8, yang merupakan bilangan bulat 64-bit.
UInt64 Nilai harus berupa VT_UI8, yang merupakan bilangan bulat yang tidak ditandatangani 64-bit.
Ganda Nilai harus berupa VT_R8, yang merupakan ganda.
DateTime Nilai harus berupa VT_FILETIME, yang merupakan FILETIME.
Guid Nilai harus berupa VT_CLSID, yang merupakan pengidentifikasi kelas (CLSID).
Blob Nilai harus berupa VT_BLOB, yang merupakan byte berawalan panjang.
Stream Nilai harus berupa VT_STREAM, yang merupakan objek yang mengimplementasikan IStream.
Clipboard Nilai harus berupa VT_CF, yang merupakan format clipboard.
Object Nilai harus berupa VT_UNKNOWN, yang merupakan objek yang mengimplementasikan IUnknown.

 

groupingRange Pilihan. Defaultnya adalah "Diskrit". Menentukan bagaimana properti ditampilkan saat tampilan dikelompokkan menurut properti ini. Setelah diatur di sini, nilai-nilai ini diambil oleh IPropertyDescription::GetGroupingRange. Berikut ini adalah jenis yang valid.
Nilai Makna
Diskrit Default. Menampilkan nilai individual.
Alfanumerik Menampilkan rentang alfanumerik statis untuk nilai.
Ukuran Menampilkan rentang ukuran statis untuk nilai.
Tanggal Menampilkan grup bulan/tahun. Default untuk properti type="DateTime".
TimeRelative Ditampilkan dalam grup relatif waktu.
Dinamis Menampilkan rentang yang dibuat secara dinamis untuk nilai.
Persen Menampilkan wadah persen.

 

isInnate Publik. Pilihan. Defaultnya adalah "false". Menentukan apakah properti dianggap bawaan. Properti bawaan adalah properti yang dihitung dari konten file, atau dari sumber daya atau sistem lain. Misalnya, System.Size adalah properti bawaan yang disediakan oleh sistem file; mengubah nilai properti dalam dan dari dirinya sendiri tidak melakukan apa pun. Contoh lain adalah System.Image.Dimensions dan System.Document.PageCount, yang dihitung oleh program berdasarkan konten file, tidak didasarkan pada pengaturan yang dapat diubah pengguna. Pengaturan isInnate="true" berarti pengguna tidak dapat mengedit properti ini secara langsung melalui kontrol properti. Nilai ini dipetakan ke bendera PDTF_ISINNATE yang ditentukan dalam PROPDESC_TYPE_FLAGS dan digunakan dalam IPropertyDescription::GetTypeFlags.
canBePurged Windows Vista dengan Paket Layanan 1 (SP1) dan yang lebih baru saja. Publik. Pilihan. Ketika diatur ke "true", memungkinkan properti bawaan dihapus. Properti bawaan, yang dihitung dari properti lain, bersifat baca-saja menurut definisi. Nilai default untuk atribut ini bergantung pada nilai isInnate .
isInnate nilai default canBePurged
TRUE false
false TRUE

 

Catatan:
Properti yang nilai isInnate-nya adalah "false" (artinya properti baca/tulis) juga tidak dapat mengatur nilai canBePurged ke "false". Pembatasan ini diberlakukan oleh sistem operasi.

 

Meskipun atribut ini diperkenalkan di Windows Vista dengan Paket Layanan 1 (SP1), file .propdesc yang menyertakan atribut ini kompatibel dengan Windows Vista sebelum Windows Vista dengan SP1. Atribut canBePurged hanya diabaikan dalam situasi tersebut.

multipleValues Publik. Pilihan. Defaultnya adalah "false". Menentukan apakah properti ini bisa memiliki beberapa nilai. Nilai ini memetakan ke bendera PDTF_MULTIPLEVALUES yang ditentukan dalam PROPDESC_TYPE_FLAGS dan digunakan dalam IPropertyDescription::GetTypeFlags. Ini juga memengaruhi apakah VT_VECTOR adalah OR ke VARTYPE dari nilai properti.
isGroup Publik. Pilihan. Defaultnya adalah "false". Menentukan apakah properti adalah judul grup. Judul grup benar-benar digunakan dalam proplis, tidak memiliki nilai, tidak pernah disimpan dalam file, dan juga harus memiliki <typeInfo type="Null">. Beberapa UI dalam sistem menggunakan proplis untuk menunjukkan urutan properti yang akan ditampilkan. Proplis ini dapat mencakup referensi ke judul grup (misalnya, System.PropGroup.Camera), yang memberi tahu UI untuk memulai bagian grup baru (misalnya, "Pengaturan Kamera"). Deskripsi properti dengan isGroup="true" harus menentukan <labelInfo label="Beberapa label yang dilokalkan">, jika tidak, itu bukan properti yang berguna. Nilai ini memetakan ke bendera PDTF_ISGROUP yang ditentukan dalam PROPDESC_TYPE_FLAGS dan digunakan dalam IPropertyDescription::GetTypeFlags.
aggregationType Publik. Pilihan. Defaultnya adalah "Default". Menentukan bagaimana properti agregat ditampilkan ketika beberapa item dipilih. Setelah diatur di sini, nilai-nilai ini diambil oleh IPropertyDescription::GetAggregationType sebagai PROPDESC_AGGREGATION_TYPE. Berikut ini adalah jenis yang valid.
Nilai Makna
Default Default. Menampilkan tempat penampung Beberapa Nilai di UI. Ini adalah default jika jenis tidak kompatibel dengan agregasiType yang ditentukan.
Pertama Menampilkan nilai properti dari item pertama dalam pilihan atau koleksi.
Jumlah total Menampilkan jumlah nilai numerik. Berguna untuk properti seperti System.Media.Duration atau System.Size. Nilai ini tidak kompatibel dengan jenis non-numerik.
Rata-rata Menampilkan rata-rata nilai numerik. Berguna untuk properti seperti System.Rating. Nilai ini tidak kompatibel dengan jenis non-numerik.
DateRange Menampilkan rentang tanggal. Berguna untuk properti seperti System.Photo.DateTaken. Nilai ini tidak kompatibel dengan apa pun kecuali type="DateTime" dan merupakan default untuk properti jenis tersebut.
Union Menampilkan gabungan semua nilai dalam pilihan atau koleksi. Urutan nilai yang ditampilkan tidak ditentukan. Nilai ini adalah default untuk properti type="String" dan multipleValues="true".
Maksimum Menampilkan nilai maksimum dalam koleksi. Berguna untuk properti seperti System.DateModified. Tidak kompatibel dengan tipe non-numerik atau non-tanggal.
Minimum Menampilkan nilai minimum dalam koleksi. Tidak kompatibel dengan tipe non-numerik atau non-tanggal.

 

isTreeProperty Publik. Pilihan. Nilai defaultnya adalah "false".
isViewable Publik. Pilihan. Nilai defaultnya adalah "false". Menentukan apakah properti ini dimaksudkan untuk dapat dilihat oleh pengguna. Misalnya, UI Pemilih Kolom hanya menampilkan properti yang memiliki isViewable="true". Pengecualiannya adalah UI yang didorong oleh proplis, yang akan selalu menampilkan properti . Jika Anda memiliki properti yang hanya dimaksudkan untuk melakukan antar-jemput data di antara dua objek, dan tidak pernah dimaksudkan untuk dilihat oleh pengguna, atribut ini harus salah. Nilai ini dipetakan ke bendera PDTF_ISVIEWABLE yang ditentukan dalam PROPDESC_TYPE_FLAGS dan digunakan dalam IPropertyDescription::GetTypeFlags.
dapat dikueri Hanya Windows Vista. Tidak didukung di Windows 7 dan yang lebih baru. Publik. Pilihan. Nilai defaultnya adalah "false". Menentukan apakah properti ini dimaksudkan untuk tersedia di UI Penyusun Kueri Pencarian. Properti harus memiliki isViewable="true" sebelum isQueryable="true" dihormati. Nilai ini dipetakan ke bendera PDTF_ISQUERYABLE yang ditentukan dalam PROPDESC_TYPE_FLAGS dan digunakan dalam IPropertyDescription::GetTypeFlags.
searchRawValue Windows 7 dan yang lebih baru. Publik. Pilihan. Nilai defaultnya adalah "false".
includeInFullTextQuery Hanya Windows Vista. Tidak didukung di Windows 7 dan yang lebih baru. Publik. Pilihan. Nilai defaultnya adalah "false".
conditionType Publik. Pilihan. Defaultnya adalah "String". Menentukan petunjuk ke UI Penyusun Kueri Pencarian sehingga dapat menentukan daftar kemungkinan operator kondisi di dalam predikat. Berikut ini adalah nilai yang dikenali.
Nilai Makna
String Default. Operator berikut akan digunakan: "is", "is not", "<", ">", "", "<=", ">=", "starts with", "ends with", "contains", "not't contain", "is like".
Telepon Default untuk properti numerik. Operator berikut akan digunakan: "sama dengan", "tidak sama dengan", "kurang dari", "lebih besar dari", "kurang dari atau sama dengan", "lebih besar dari atau sama dengan".
DateTime Default untuk properti type="DateTime". Operator berikut akan digunakan: "is", "is not", "is before", "is after", "is before", "is before but includes", "is after but includes".
Boolean Default untuk properti type="Boolean". Sama seperti Angka.
Ukuran Sama seperti Angka.

 

defaultOperation Publik. Pilihan. Defaultnya adalah "Sama Dengan". Menentukan petunjuk ke alat Penyusun Kueri Pencarian sehingga dapat menentukan operator default. Nilai yang mungkin adalah sebagai berikut:
Nilai Makna
Equal Default. Menunjukkan setara.
NotEqual Menunjukkan tidak setara.
LessThan Menunjukkan kurang dari.
GreaterThan Default untuk properti conditionType="Size". Menunjukkan lebih besar dari.
Berisi Default untuk properti conditionType="String". Menunjukkan penyertaan.