System.ItemNameDisplay
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 |
Tópicos relacionados