typeInfo

  • 아티클

속성의 형식 정보를 지정합니다. 각 propertyDescription에 대해 하나의 typeInfo 요소만 있어야 합니다. 이 요소는 Windows 7에 대해 변경되었습니다.

요소가 여러 개 있는 경우 마지막 요소가 사용됩니다. typeInfo 요소가 제공되지 않으면 기본 특성 설정이 속성 설명에 적용됩니다.

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>

요소 정보

부모 요소 자식 요소
propertyDescription 없음

 

특성

attribute Description
type 공개. 선택 사항입니다. 기본값은 "Any"입니다. 속성의 형식을 나타냅니다. 다음은 유효한 형식이며 IPropertyDescription::GetPropertyType에서 연결된 변형 형식을 검색합니다.
값 의미
모두 기본값 속성 하위 시스템은 속성 값을 적용하거나 강제 변환하지 않습니다. IPropertyDescription::GetPropertyType 은 VT_NULL 반환합니다. ISV(독립 소프트웨어 공급업체)는 이 기본값으로 되돌리는 대신 형식을 제공하는 것이 좋습니다.
Null 이 속성에 대한 값이 없습니다. IPropertyDescription::GetPropertyType 은 VT_NULL 반환합니다.
String 값은 null 참조로 종료된 유니코드 문자열인 VT_LPWSTR 이어야 합니다.
부울 값은 부울인 VT_BOOL 이어야 합니다.
Byte 값은 바이트인 VT_UI1 이어야 합니다.
Buffer 값은 VT_UI1 | 바이트의 버퍼를 VT_VECTOR.
Int16 값은 16비트 정수인 VT_I2 이어야 합니다.
UInt16 값은 VT_UI2 16비트 부호 없는 정수여야 합니다.
Int32 값은 VT_I4 32비트 정수여야 합니다.
UInt32 값은 VT_UI4 32비트 부호 없는 정수여야 합니다.
Int64 값은 64비트 정수인 VT_I8 이어야 합니다.
UInt64 값은 VT_UI8 64비트 부호 없는 정수여야 합니다.
Double 값은 double인 VT_R8 이어야 합니다.
DateTime 값은 FILETIME인 VT_FILETIME 이어야 합니다.
Guid 값은 CLSID(클래스 식별자)인 VT_CLSID 이어야 합니다.
Blob 값은 길이 접두사 바이트인 VT_BLOB 이어야 합니다.
STREAM 값은 IStream을 구현하는 개체인 VT_STREAM 이어야 합니다.
클립보드 값은 클립보드 형식인 VT_CF 이어야 합니다.
Object 값은 IUnknown을 구현하는 개체인 VT_UNKNOWN 이어야 합니다.

 
groupingRange 선택 사항입니다. 기본값은 "Discrete"입니다. 뷰가 이 속성으로 그룹화될 때 속성이 표시되는 방식을 지정합니다. 여기서 설정되면 IPropertyDescription::GetGroupingRange에서 이러한 값을 검색합니다. 다음은 유효한 형식입니다.
값 의미
불연속 기본값 개별 값을 표시합니다.
영숫자 값에 대한 정적 영숫자 범위를 표시합니다.
크기 값의 정적 크기 범위를 표시합니다.
Date 월/연도 그룹을 표시합니다. type="DateTime"의 속성에 대한 기본값입니다.
TimeRelative 시간 상대 그룹에 표시됩니다.
동적 값에 대해 동적으로 생성된 범위를 표시합니다.
백분율 백분율 버킷을 표시합니다.

 
isInnate 공개. 선택 사항입니다. 기본값은 "false"입니다. 속성이 타고난 것으로 간주되는지 여부를 지정합니다. 타고난 속성은 파일의 콘텐츠 또는 다른 리소스 또는 시스템에서 계산되는 속성입니다. 예를 들어 System.Size는 파일 시스템에서 제공하는 타고난 속성입니다. 및 자체에서 속성의 값을 변경해도 아무 것도 수행하지 않습니다. 다른 예로 System.Image.Dimensions 및 System.Document.PageCount는 사용자가 변경할 수 있는 설정을 기반으로 하지 않고 파일의 내용을 기반으로 프로그램에 의해 계산됩니다. isInnate="true"를 설정하면 사용자가 속성 컨트롤을 통해 이 속성을 직접 편집할 수 없습니다. 이 값은 PROPDESC_TYPE_FLAGS 정의되고 IPropertyDescription::GetTypeFlags에 사용되는 PDTF_ISINNATE 플래그에 매핑됩니다.
canBePurged Windows Vista SP1(서비스 팩 1) 이상만 해당합니다. 공개. 선택 사항입니다. "true"로 설정하면 타고난 속성을 삭제할 수 있습니다. 다른 속성에서 계산되는 타고난 속성은 정의에 따라 읽기 전용입니다. 이 특성의 기본값은 isInnate 값에 따라 달라집니다.
isInnate canBePurged 기본값
true false
false true

 

참고:
isInnate 값이 "false"(속성이 읽기/쓰기임을 의미)인 속성은 canBePurged 값을 "false"로 설정할 수도 없습니다. 이 제한은 운영 체제에 의해 적용됩니다.

 

이 특성은 Windows Vista SP1(서비스 팩 1)에서 도입되었지만 이 특성을 포함하는 .propdesc 파일은 Windows Vista SP1 이전의 Windows Vista와 호환됩니다. canBePurged 특성은 해당 상황에서 무시됩니다.
multipleValues 공개. 선택 사항입니다. 기본값은 "false"입니다. 이 속성에 여러 값이 있을 수 있는지 여부를 지정합니다. 이 값은 PROPDESC_TYPE_FLAGS 정의되고 IPropertyDescription::GetTypeFlags에 사용되는 PDTF_MULTIPLEVALUES 플래그에 매핑됩니다. 이는 VT_VECTOR 속성 값의 VARTYPE에 대한 OR인지 여부에도 영향을 줍니다.
isGroup 공개. 선택 사항입니다. 기본값은 "false"입니다. 속성이 그룹 머리글인지 여부를 지정합니다. 그룹 제목은 proplists에서 엄격하게 사용되며, 값이 없으며, 파일에 저장되지 않으며, typeInfo type="Null">도 포함<해야 합니다. 시스템의 일부 UI는 proplists를 사용하여 표시할 속성의 시퀀스를 나타냅니다. 이러한 제안 목록에는 UI에 새 그룹 섹션(예: "카메라 설정")을 시작하도록 지시하는 그룹 제목(예: System.PropGroup.Camera)에 대한 참조가 포함될 수 있습니다. isGroup="true"를 사용하는 속성 설명은 labelInfo label="Some localized label">을 지정<해야 합니다. 그렇지 않으면 유용한 속성이 아닙니다. 이 값은 PROPDESC_TYPE_FLAGS 정의되고 IPropertyDescription::GetTypeFlags에서 사용되는 PDTF_ISGROUP 플래그에 매핑됩니다.
aggregationType 공개. 선택 사항입니다. 기본값은 "기본값"입니다. 여러 항목을 선택할 때 집계 속성이 표시되는 방식을 지정합니다. 여기서 설정되면 IPropertyDescription::GetAggregationType 에서 이러한 값을 PROPDESC_AGGREGATION_TYPE 검색합니다. 다음은 유효한 형식입니다.
값 의미
기본값 기본값 UI에 여러 값 자리 표시자를 표시합니다. 형식이 지정된 aggregationType과 호환되지 않는 경우 기본값입니다.
첫 번째 선택 영역 또는 컬렉션에서 첫 번째 항목의 속성 값을 표시합니다.
합계 숫자 값의 합계를 표시합니다. System.Media.Duration 또는 System.Size와 같은 속성에 유용합니다. 이 값은 숫자가 아닌 형식과 호환되지 않습니다.
평균 숫자 값의 평균을 표시합니다. System.Rating과 같은 속성에 유용합니다. 이 값은 숫자가 아닌 형식과 호환되지 않습니다.
DateRange 날짜 범위를 표시합니다. System.Photo.DateTaken과 같은 속성에 유용합니다. 이 값은 type="DateTime"을 제외한 모든 값과 호환되지 않으며 해당 형식의 속성에 대한 기본값입니다.
Union 선택 영역 또는 컬렉션에 있는 모든 값의 합집합을 표시합니다. 값이 표시되는 순서는 정의되지 않습니다. 이 값은 type="String" 및 multipleValues="true"의 속성에 대한 기본값입니다.
최대 컬렉션의 최대값을 표시합니다. System.DateModified와 같은 속성에 유용합니다. 숫자가 아닌 형식 또는 날짜가 아닌 형식과 호환되지 않습니다.
최소 컬렉션의 최소값을 표시합니다. 숫자가 아닌 형식 또는 날짜가 아닌 형식과 호환되지 않습니다.

 
isTreeProperty 공개. 선택 사항입니다. 기본값은 "false"입니다.
isViewable 공개. 선택 사항입니다. 기본값은 "false"입니다. 이 속성을 사용자에게 표시할 수 있는지 여부를 지정합니다. 예를 들어 열 선택기 UI에는 isViewable="true"가 있는 속성만 표시됩니다. 예외는 속성이 항상 표시되는 proplist에 의해 구동되는 UI입니다. 두 개체 간에만 데이터를 셔틀하기 위한 속성이 있고 사용자가 볼 수 없는 경우 이 특성은 false여야 합니다. 이 값은 PROPDESC_TYPE_FLAGS 정의되고 IPropertyDescription::GetTypeFlags에 사용되는 PDTF_ISVIEWABLE 플래그에 매핑됩니다.
isQueryable Windows Vista에만 해당합니다. Windows 7 이상에서는 지원되지 않습니다. 공개. 선택 사항입니다. 기본값은 "false"입니다. 이 속성을 검색 쿼리 작성기 UI에서 사용할 수 있는지 여부를 지정합니다. isQueryable="true"가 적용되기 전에 속성에 isViewable="true"가 있어야 합니다. 이 값은 PROPDESC_TYPE_FLAGS 정의되고 IPropertyDescription::GetTypeFlags에 사용되는 PDTF_ISQUERYABLE 플래그에 매핑됩니다.
searchRawValue Windows 7 이상 공개. 선택 사항입니다. 기본값은 "false"입니다.
includeInFullTextQuery Windows Vista에만 해당합니다. Windows 7 이상에서는 지원되지 않습니다. 공개. 선택 사항입니다. 기본값은 "false"입니다.
conditionType 공개. 선택 사항입니다. 기본값은 "String"입니다. 조건자 내에서 가능한 조건자 목록을 확인할 수 있도록 검색 쿼리 작성기 UI에 대한 힌트를 지정합니다. 다음은 인식된 값입니다.
값 의미
String 기본값 다음 연산자가 사용됩니다. "is", "is not", "", "<>", "", "<=", ">=", "starts with", "ends with", "contains", "contain't contain", "is like".
숫자 숫자 속성의 기본값입니다. "같음", "같지 않음", "보다 작음", "보다 큼", "보다 작거나 같음", "보다 크거나 같음" 연산자가 사용됩니다.
DateTime type="DateTime"의 속성에 대한 기본값입니다. "is", "is not", "is before", "is after", "is before but includes", "is after but includes"와 같은 연산자가 사용됩니다.
부울 type="Boolean"의 속성에 대한 기본값입니다. Number와 동일합니다.
크기 Number와 동일합니다.

 
defaultOperation 공개. 선택 사항입니다. 기본값은 "Equal"입니다. 기본 연산자를 확인할 수 있도록 쿼리 작성기 검색 도구에 대한 힌트를 지정합니다. 가능한 값은 다음과 같습니다.
값 의미
같음 기본값 동등한 것을 나타냅니다.
NotEqual 동일하지 않음을 나타냅니다.
LessThan 보다 작음 을 나타냅니다.
GreaterThan conditionType="Size"의 속성에 대한 기본값입니다. 보다 큼을 나타냅니다.
포함 conditionType="String"의 속성에 대한 기본값입니다. 포함을 나타냅니다.