SHGNO

9/9/2008

Essa enumeração define os valores usados com o IShellFolder::GetDisplayNameOf e IShellFolder::SetNameOf Métodos.

Syntax

typedef enum tagSHGDN {
  SHGDN_NORMAL,
  SHGDN_INFOLDER,
  SHGDN_FOREDITING,
  SHGDN_FORADDRESSBAR,
  SHGDN_FORPARSING
} SHGNO;

Elementos

• SHGDN_NORMAL
  Nome completo. O nome é relativo para o computador desktop e não para uma pasta específica. Esse valor é usado para genérico exibir o nome do objeto especificado arquivo ou subpasta.

• SHGDN_INFOLDER
  Nome relativo. O nome é relativo para a pasta que é processamento de nome.

• SHGDN_FOREDITING
  O nome é usado para in-place editing quando o usuário renomeia o item.

• SHGDN_FORADDRESSBAR
  O nome é exibido em um endereço caixa de combinação barra.

• SHGDN_FORPARSING
  O nome é usado para análise. Ou seja, ele pode ser passado para IShellFolder::ParseDisplayName Para recuperar ponteiro do objeto para uma lista identificador item (PIDL). A forma que utiliza esse nome depende de como o objeto específico.

Remarks

Essa enumeração consiste de dois grupos de valores. A primeira GRUPO — SHGDN_NORMAL e SHGDN_INFOLDER — especifica tipo o nome do. O segundo GRUPO — SHGDN_FOREDITING, SHGDN_FORADDRESSBAR e SHGDN_FORPARSING — consiste modificadores para a primeira GRUPO que Nome especificar opções de recuperação.

Se estiver definido SHGDN_FORPARSING e SHGDN_INFOLDER não estiver definido, IShellFolder::GetDisplayNameOf pode aceitar um PIDL que contém more than um SHITEMID estrutura. Caso contrário, somente uma única-nível PIDL pode ser passado.

Embora a análise nome retornado por objetos sistema de arquivos caminho totalmente qualificado do o objeto, pastas virtuais podem usar algo bastante diferentes. De exemplo, algumas pastas virtuais usar um identificador exclusivo (GUID) como a análise Nome e retorna um seqüência de caracteres da forma ":: {GUID} ". Para verificar se o objeto é parte de sistema de arquivos, chamar IShellFolder::GetAttributesOf e veja se o sinalizador SFGAO_FILESYSTEM será definida. Se você estiver implementando IShellFolder::GetDisplayNameOf, é incentivados a retornar analisados nomes que são como fechar aos nomes de exibir como possíveis. Essa prática ajuda a usuário final para tipo ou editar esses nomes.

O valor numérico de SHGDN_NORMAL é zero, portanto, não é possível testar a presença desse bit. Considere SHGDN_NORMAL um configuração padrão que é usado se nenhum outro sinalizador no que GRUPO está definido.

Exemplo

O seguinte tabelas apresentação um exemplo dos possíveis valores de retorno para cinco sinalizador diferentes opções e três tipos diferentes item.

A seguinte tabela mostra as opções sinalizador.

Número	Sinalizadores	Descrição
1	SHGDN_NORMAL | SHGDN_FORPARSING	Retorna o totalmente qualificado análise Nome.
2	SHGDN_INFOLDER | SHGDN_FORPARSING	Retorna que a análise nome relativo para a pasta pai.
3	SHGDN_INFOLDER | SHGDN_FOREDITING	Retorna que a edição nome relativo para a pasta pai.
4	SHGDN_INFOLDER	Retorna o nome exibir relativo para a pasta pai.
5	SHGDN_NORMAL	Retorna o nome exibir relativo para o área de trabalho.

A seguinte tabela mostra os tipos item exemplo.

Letra	Descrição
A	Um nomeado da impressora laser em um computador chamado Mailroom.
B	O arquivo C:\Directory\File.txt (quando as extensões de nome arquivo estão ocultos).

A seguinte tabela mostra os nomes exibir, conforme eles deve ser retornados.

Número	A	B
1	\\Mailroom\Laser	C:\Directory\File.txt
2	Laser	Arquivo.txt
3	Laser	Arquivo
4	Laser	Arquivo
5	A laser em Mailroom	Arquivo

Comentários sobre Exemplos:

• A1-A5: Nome do remoto exibir impressora muda dependendo se ele está sendo mostrado relativo a seu pai. Quando mostrado relativo a seu pai, somente o nome da impressora é necessária, mas quando mostrado fora seu pai, tanto o nome da impressora e nome do computador são necessários.
• B3: Arquivo.txt apresenta somente seu nome de base para edição instead of o nome completo.

Requirements

Header	shobjidl.h, shobjidl.idl
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

Standard Shell Enumerations
IShellFolder
SHGetDesktopFolder