System.ItemNameDisplay

  • 아티클

"가장 완전한" 형식의 표시 이름입니다. 최종 사용자에게 가장 적합한 항목 이름의 고유한 표현입니다.

Windows 10, 버전 1703, Windows 10, 버전 1607, Windows 10, 버전 1511, Windows 10, 버전 1507, Windows 8.1, Windows 8, Windows 7, Windows Vista

propertyDescription
   name = System.ItemNameDisplay
   shellPKey = PKEY_ItemNameDisplay
   formatID = B725F130-47EF-101A-A5F1-02608C9EEBAC
   propID = 10
   SearchInfo
      InInvertedIndex = true
      IsColumn = true
   typeInfo
      type = String
      IsInnate = true

설명

PKEY 값은 Propkey.h에 정의되어 있습니다.

이 값은 System.ItemNamePrefix 및 System.ItemName의 연결입니다.

항목이 파일인 경우 이 속성은 파일 탐색기 표시된 대로 표시 이름을 포함합니다. System.FileName이 제공되지만 이 속성의 값이 완전히 다른 경우는 허용됩니다. 전자 메일 메시지는 좋은 예입니다. 항목이 전자 메일 메시지인 경우 항목 이름은 일반적으로 제목입니다. 이 경우 값은 System.ItemNamePrefix 및 System.ItemName의 연결이어야 합니다. System.ItemNamePrefix 값은 후행 공백을 제외하므로 System.ItemNameDisplay를 생성할 때 연결에 공백이 포함되어야 합니다. 이 속성은 고유하게 보장되지는 않지만 고유할 수 있고 최종 사용자에게도 적합한 가장 가능성이 높은 후보를 승격하도록 설계되었습니다.

예를 들어 문서의 경우 System.Title 을 System.ItemNameDisplay로 사용할 수 있지만 실제로 문서 제목은 유일한 System.ItemNameDisplay로 작동할 만큼 유용하거나 고유하지 않을 수 있습니다. 대신 System.ItemNameDisplay의 값으로 System.FileName 을 제공하는 것이 더 좋습니다. Windows Mail에서 전자 메일은 파일 시스템에 .eml 파일로 저장됩니다. 이러한 파일에 대한 System.FileName 값은 GUID이므로 사용자에게 친숙하지 않습니다. 이 예제에서는 System.Subject 를 System.ItemNameDisplay로 승격하는 것이 더 합리적입니다.

호환성 정보:

  • Windows Vista의 셸 폴더 구현: Windows Explorer IShellFolder::GetDisplayNameOf(SHGDN_NORMAL)를 호출하여 이름 값을 가져올 때 이름 열에 PKEY_ItemNameDisplay 사용합니다. Windows Explorer 폴더의 속성 저장소 또는 IShellFolder2::GetDetailsEx를 호출하여 이름 값을 가져올 때 PKEY_ItemName 같은 다른 PKEY를 사용합니다.
  • Windows XP의 셸 폴더 구현: 첫 번째 열은 이름 열이어야 하며 Windows Explorer IShellFolder::GetDisplayNameOf를 호출하여 이름 값을 가져옵니다. PKEY/SCID는 중요하지 않습니다.
항목 유형 예제
파일 hello.txt
메시지 Re: 모임은 어디에 있나요?
디바이스 폴더 song.wma
폴더 문서

 

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

drawControl

editControl

filterControl

queryControl