Compartir a través de


typeInfo

Especifica la información de tipo de una propiedad. Solo debe haber un elemento typeInfo para cada propertyDescription. Este elemento ha cambiado para Windows 7.

Si hay varios elementos, se usa el último. Si no se proporciona ningún elemento typeInfo , la configuración de atributo predeterminada se aplica a la descripción de la propiedad.

Sintaxis para 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>

Información de elemento

Elemento primario Elementos secundarios
propertyDescription None

 

Atributos

Atributo Descripción
type Público. Opcional. El valor predeterminado es "Any". Indica el tipo de la propiedad . Los siguientes son tipos válidos y IPropertyDescription::GetPropertyType recupera sus tipos de variante asociados.
Valor Significado
Any Predeterminada. El subsistema de propiedades no aplicará ni coercerá el valor de la propiedad. IPropertyDescription::GetPropertyType devuelve VT_NULL. Se recomienda encarecidamente a los proveedores de software independientes (ISV) proporcionar un tipo en lugar de recurrir a este valor predeterminado.
Null No hay ningún valor para esta propiedad. IPropertyDescription::GetPropertyType devuelve VT_NULL.
String El valor debe ser un VT_LPWSTR, que es una cadena Unicode terminada por una referencia nula.
Boolean El valor debe ser un VT_BOOL, que es un valor booleano.
Byte El valor debe ser un VT_UI1, que es un byte.
Buffer El valor debe ser un VT_UI1 | VT_VECTOR búfer de bytes.
Int16 El valor debe ser un VT_I2, que es un entero de 16 bits.
UInt16 El valor debe ser un VT_UI2, que es un entero de 16 bits sin signo.
Int32 El valor debe ser un VT_I4, que es un entero de 32 bits.
UInt32 El valor debe ser un VT_UI4, que es un entero de 32 bits sin signo.
Int64 El valor debe ser un VT_I8, que es un entero de 64 bits.
UInt64 El valor debe ser un VT_UI8, que es un entero de 64 bits sin signo.
Doble El valor debe ser un VT_R8, que es un doble.
DateTime El valor debe ser un VT_FILETIME, que es filetime.
Guid El valor debe ser un VT_CLSID, que es un identificador de clase (CLSID).
Blob El valor debe ser un VT_BLOB, que son bytes con prefijo de longitud.
STREAM El valor debe ser un VT_STREAM, que es un objeto que implementa IStream.
Portapapeles El valor debe ser un VT_CF, que es un formato de Portapapeles.
Objeto El valor debe ser un VT_UNKNOWN, que es un objeto que implementa IUnknown.

 

groupingRange Opcional. El valor predeterminado es "Discrete". Especifica cómo se muestra la propiedad cuando esta propiedad agrupa una vista. Una vez establecido aquí, IPropertyDescription::GetGroupingRange recupera estos valores. Los siguientes son tipos válidos.
Valor Significado
Discrete Predeterminada. Muestra valores individuales.
Alfanuméricas Muestra intervalos alfanuméricos estáticos para los valores.
Size Muestra intervalos de tamaño estáticos para los valores.
Date Muestra grupos de meses y años. Valor predeterminado para las propiedades de type="DateTime".
TimeRelative Se muestra en grupos relativos al tiempo.
Dinámica Muestra intervalos creados dinámicamente para los valores.
Percent Muestra los cubos de porcentaje.

 

isInnate Público. Opcional. El valor predeterminado es "false". Especifica si la propiedad se considera innata. Una propiedad innate es una que se calcula a partir del contenido de un archivo o de otros recursos o sistemas. Por ejemplo, System.Size es una propiedad innate proporcionada por el sistema de archivos; cambiar el valor de la propiedad en y de sí mismo no hace nada. Otros ejemplos son System.Image.Dimensions y System.Document.PageCount, que se calculan mediante programas basados en el contenido del archivo, no en función de una configuración modificable por el usuario. Establecer isInnate="true" significa que el usuario no puede editar esta propiedad directamente a través de un control de propiedad. Este valor se asigna a la marca PDTF_ISINNATE definida en PROPDESC_TYPE_FLAGS y se usa en IPropertyDescription::GetTypeFlags.
canBePurged Windows Vista solo con Service Pack 1 (SP1) y versiones posteriores. Público. Opcional. Cuando se establece en "true", permite eliminar una propiedad innate. Las propiedades innatos, que se calculan a partir de otras propiedades, son de solo lectura por definición. El valor predeterminado de este atributo depende del valor isInnate .
isInnate valor predeterminado canBePurged
true false
false true

 

Nota:
Una propiedad cuyo valor isInnate es "false" (lo que significa que la propiedad es de lectura y escritura) tampoco puede establecer el valor canBePurged en "false". El sistema operativo aplica esta restricción.

 

Aunque este atributo se introdujo en Windows Vista con Service Pack 1 (SP1), un archivo .propdesc que incluye este atributo es compatible con Windows Vista antes de Windows Vista con SP1. El atributo canBePurged simplemente se omite en esa situación.

multipleValues Público. Opcional. El valor predeterminado es "false". Especifica si esta propiedad puede tener varios valores. Este valor se asigna a la marca PDTF_MULTIPLEVALUES definida en PROPDESC_TYPE_FLAGS y se usa en IPropertyDescription::GetTypeFlags. Esto también influye en si VT_VECTOR es OR al VARTYPE del valor de propiedad.
isGroup Público. Opcional. El valor predeterminado es "false". Especifica si la propiedad es un encabezado de grupo. Un encabezado de grupo se usa estrictamente en listas proplist, no tiene ningún valor, nunca se almacena en un archivo y también debe tener <typeInfo type="Null".> Algunas interfaces de usuario del sistema usan proplists para indicar la secuencia de las propiedades que se van a mostrar. Estas listas de propiedades pueden incluir referencias a encabezados de grupo (por ejemplo, System.PropGroup.Camera), que indican a la interfaz de usuario que inicie una nueva sección de grupo (por ejemplo, "Configuración de la cámara"). Una descripción de propiedad con isGroup="true" debe especificar un <labelInfo label="Some localized label">; de lo contrario, no es una propiedad útil. Este valor se asigna a la marca PDTF_ISGROUP definida en PROPDESC_TYPE_FLAGS y se usa en IPropertyDescription::GetTypeFlags.
AggregationType Público. Opcional. El valor predeterminado es "Default". Especifica cómo se muestran las propiedades de agregado cuando se seleccionan varios elementos. Una vez establecido aquí, IPropertyDescription::GetAggregationType recupera estos valores como un PROPDESC_AGGREGATION_TYPE. Los siguientes son tipos válidos.
Valor Significado
Valor predeterminado Predeterminada. Muestra un marcador de posición de varios valores en la interfaz de usuario. Este es el valor predeterminado si el tipo no es compatible con el aggregationType especificado.
First Muestra el valor de propiedad del primer elemento de la selección o colección.
Sum Muestra la suma de los valores numéricos. Útil para propiedades como System.Media.Duration o System.Size. Este valor no es compatible con tipos no numéricos.
Media Muestra el promedio de los valores numéricos. Útil para propiedades como System.Rating. Este valor no es compatible con tipos no numéricos.
DateRange Muestra un intervalo de fechas. Útil para propiedades como System.Photo.DateTaken. Este valor no es compatible con nada excepto type="DateTime" y es el valor predeterminado para las propiedades de ese tipo.
Union Muestra una unión de todos los valores de la selección o colección. El orden en el que se muestran los valores es indefinido. Este valor es el valor predeterminado para las propiedades de type="String" y multipleValues="true".
Máxima Muestra el valor máximo de la colección. Útil para propiedades como System.DateModified. No es compatible con tipos no numéricos o no de fecha.
Mínima Muestra el valor mínimo de la colección. No es compatible con tipos no numéricos o no de fecha.

 

isTreeProperty Público. Opcional. El valor predeterminado es "false".
isViewable Público. Opcional. El valor predeterminado es "false". Especifica si esta propiedad está pensada para ser visible para el usuario. Por ejemplo, la interfaz de usuario del selector de columnas solo muestra las propiedades que tienen isViewable="true". La excepción es la interfaz de usuario controlada por una lista de propiedades, que siempre mostrará la propiedad . Si tiene una propiedad que solo está pensada para transferir datos entre dos objetos y nunca pretende ser visto por el usuario, este atributo debe ser false. Este valor se asigna a la marca PDTF_ISVIEWABLE definida en PROPDESC_TYPE_FLAGS y se usa en IPropertyDescription::GetTypeFlags.
isQueryable Solo Windows Vista. No se admite en Windows 7 y versiones posteriores. Público. Opcional. El valor predeterminado es "false". Especifica si esta propiedad está pensada para estar disponible en la interfaz de usuario del Generador de consultas de búsqueda. Una propiedad debe tener isViewable="true" antes de que se respete isQueryable="true". Este valor se asigna a la marca PDTF_ISQUERYABLE definida en PROPDESC_TYPE_FLAGS y se usa en IPropertyDescription::GetTypeFlags.
searchRawValue Windows 7 y versiones posteriores. Público. Opcional. El valor predeterminado es "false".
includeInFullTextQuery Solo Windows Vista. No se admite en Windows 7 y versiones posteriores. Público. Opcional. El valor predeterminado es "false".
conditionType Público. Opcional. El valor predeterminado es "String". Especifica una sugerencia a la interfaz de usuario del Generador de consultas de búsqueda para que pueda determinar la lista de posibles operadores de condición dentro de un predicado. A continuación se muestran los valores reconocidos.
Valor Significado
String Predeterminada. Se usarán los operadores siguientes: "is", "is not", "<", "", "><=", ">=", "starts with", "ends with", "contains", "doesn't contains", "is like".
Number Valor predeterminado para las propiedades numéricas. Se usarán los operadores siguientes: "equals", "doesn't equal", "is less than", "is greater than", "is less than", "is less than or equal to", "is greater than or equal to".
DateTime Valor predeterminado para las propiedades de type="DateTime". Se usarán los operadores siguientes: "is", "is not", "is before", "is after", "is before but includes", "is after but includes".
Boolean Valor predeterminado para las propiedades de type="Boolean". Igual que Number.
Size Igual que Number.

 

defaultOperation Público. Opcional. El valor predeterminado es "Equal". Especifica una sugerencia a la herramienta Generador de consultas de búsqueda para que pueda determinar el operador predeterminado. Los valores posibles son los siguientes:
Value Significado
Igual Predeterminada. Indica equivalente.
NotEqual Indica que no es equivalente.
LessThan Indica menor que.
GreaterThan Valor predeterminado para las propiedades de conditionType="Size". Indica mayor que.
Contains Valor predeterminado para las propiedades de conditionType="String". Indica la inclusión.