System.ItemNameDisplay

  • Artigo

O nome de exibição no formulário "mais completo". É a representação exclusiva do nome do item mais apropriado para os usuários finais.

Windows 10, versão 1703, Windows 10, versão 1607, Windows 10, versão 1511, Windows 10, versão 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

Comentários

Os valores PKEY são definidos em Propkey.h.

Esse valor é a concatentação de System.ItemNamePrefix e System.ItemName.

Se o item for um arquivo, essa propriedade incluirá o nome de exibição, conforme mostrado em Explorador de Arquivos. Há casos aceitáveis quando System.FileName é fornecido, mas o valor dessa propriedade é completamente diferente. Mensagens de email são um bom exemplo. Se o item for uma mensagem de email, o nome do item normalmente será o assunto. Nesse caso, o valor deve ser a concatenação de System.ItemNamePrefix e System.ItemName. Como o valor de System.ItemNamePrefix exclui quaisquer espaços à direita, a concatenação deve incluir um espaço ao gerar System.ItemNameDisplay. Observe que essa propriedade não tem garantia de ser exclusiva, mas foi projetada para promover o candidato mais provável que pode ser exclusivo e também faz sentido para os usuários finais.

Por exemplo, para documentos, o System.Title pode ser usado como System.ItemNameDisplay, mas, na prática, o título dos documentos pode não ser útil ou exclusivo o suficiente para funcionar como o único System.ItemNameDisplay. Em vez disso, fornecer System.FileName como o valor de System.ItemNameDisplay é uma opção melhor. No Windows Mail, o email é armazenado no sistema de arquivos como arquivos .eml. Os valores System.FileName para esses arquivos não são amigáveis para os humanos, pois são GUIDs. Neste exemplo, promover System.Subject como System.ItemNameDisplay faz mais sentido.

Notas de compatibilidade:

  • Implementações de pasta do Shell no Windows Vista: use PKEY_ItemNameDisplay para a coluna de nome quando desejar que o Windows Explorer chame IShellFolder::GetDisplayNameOf(SHGDN_NORMAL) para obter o valor do nome. Use outro PKEY, como PKEY_ItemName, quando quiser que o Windows Explorer chame o repositório de propriedades da pasta ou IShellFolder2::GetDetailsEx para obter o valor do nome.
  • Implementações de pasta do Shell no Windows XP: a primeira coluna deve ser a coluna de nome e o Windows Explorer chama IShellFolder::GetDisplayNameOf para obter o valor do nome. O PKEY/SCID não importa.
Tipo de item Exemplo
Arquivo olá.txt
Mensagem Re: Onde está a reunião?
Pasta do dispositivo song.wma
Pasta Documentos

 

Propertydescription

searchInfo

labelInfo

Typeinfo

displayInfo

Stringformat

booleanFormat

Numberformat

dateTimeFormat

enumeratedList

drawControl

editControl

filterControl

queryControl