Enumeração SIGDN (shobjidl_core.h)

  • Artigo

Solicita a forma do nome de exibição de um item para recuperar por meio de IShellItem::GetDisplayName e SHGetNameFromIDList.

Syntax

typedef enum _SIGDN {
  SIGDN_NORMALDISPLAY = 0,
  SIGDN_PARENTRELATIVEPARSING,
  SIGDN_DESKTOPABSOLUTEPARSING,
  SIGDN_PARENTRELATIVEEDITING,
  SIGDN_DESKTOPABSOLUTEEDITING,
  SIGDN_FILESYSPATH,
  SIGDN_URL,
  SIGDN_PARENTRELATIVEFORADDRESSBAR,
  SIGDN_PARENTRELATIVE,
  SIGDN_PARENTRELATIVEFORUI
} SIGDN;

Constantes

 
SIGDN_NORMALDISPLAY
Valor: 0
0x00000000. Retorna o nome de exibição relativo à pasta pai. Na interface do usuário, esse nome geralmente é ideal para exibição para o usuário.
SIGDN_PARENTRELATIVEPARSING
(int)0x80018001. Retorna o nome da análise em relação à pasta pai. Esse nome não é adequado para uso na interface do usuário.
SIGDN_DESKTOPABSOLUTEPARSING
(int)0x80028000. Retorna o nome da análise em relação à área de trabalho. Esse nome não é adequado para uso na interface do usuário.
SIGDN_PARENTRELATIVEEDITING
(int)0x80031001. Retorna o nome de edição em relação à pasta pai. Na interface do usuário, esse nome é adequado para exibição para o usuário.
SIGDN_DESKTOPABSOLUTEEDITING
(int)0x8004c000. Retorna o nome de edição relativo à área de trabalho. Na interface do usuário, esse nome é adequado para exibição para o usuário.
SIGDN_FILESYSPATH
(int)0x80058000. Retorna o caminho do sistema de arquivos do item, se ele tiver um. Somente os itens que relatam SFGAO_FILESYSTEM têm um caminho do sistema de arquivos. Quando um item não tiver um caminho do sistema de arquivos, uma chamada para IShellItem::GetDisplayName nesse item falhará. Na interface do usuário, esse nome é adequado para exibição para o usuário em alguns casos, mas observe que ele pode não ser especificado para todos os itens.
SIGDN_URL
(int)0x80068000. Retorna a URL do item, se tiver uma. Alguns itens não têm uma URL e, nesses casos, uma chamada para IShellItem::GetDisplayName falhará. Esse nome é adequado para exibição para o usuário em alguns casos, mas observe que ele pode não ser especificado para todos os itens.
SIGDN_PARENTRELATIVEFORADDRESSBAR
(int)0x8007c001. Retorna o caminho relativo à pasta pai em um formato amigável, conforme exibido em uma barra de endereços. Esse nome é adequado para exibição ao usuário.
SIGDN_PARENTRELATIVE
(int)0x80080001. Retorna o caminho relativo à pasta pai.
SIGDN_PARENTRELATIVEFORUI
(int)0x80094001. Introduzido no Windows 8.

Comentários

Diferentes formas do nome de um item podem ser recuperadas por meio das propriedades do item, incluindo as listadas aqui. Observe que nem todas as propriedades estão presentes em todos os itens, portanto, somente as apropriadas para o item serão exibidas.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)