Compartilhar via


Usando listas de propriedades

Depois de avaliar sua estratégia de propriedade, você deve determinar quais propriedades mostrar na interface do usuário do Windows Explorer e onde. Há vários locais em que as propriedades são exibidas de maneira somente leitura. A edição de propriedade, por outro lado, está habilitada somente na caixa de diálogo Propriedades . Essa caixa de diálogo pode ser invocada por meio do link Editar Propriedades no Painel de Visualização ou no menu de atalho de um item.

As listas de propriedades são cadeias de caracteres delimitadas por ponto e vírgula que têm o formulário a seguir.

Prop:[flags]PropertyCanonicalName;[flags]PropertyCanonicalName;

O único sinalizador disponível no momento é mostrado na tabela a seguir.

Sinalizador Descrição
* Não mostre a propriedade no Painel de Visualização conforme instruído no valor da chave do Registro PreviewDetails . Consulte o exemplo que segue a próxima tabela se o valor dessa propriedade não estiver definido.

 

Depois de definir uma lista de propriedades, você pode armazenar essa cadeia de caracteres no registro por meio do sistema de associação de arquivos shell padrão em HKEY_CLASSES_ROOT. A tabela a seguir resume os valores das listas de propriedades que podem ser atribuídas sob a chave do Registro para uma extensão de nome de arquivo específica.

Valor Descrição
FullDetails As propriedades são exibidas na guia Detalhes da caixa de diálogo Propriedades . Esta é a lista completa de propriedades compatíveis com o tipo de arquivo.
PreviewDetails As propriedades são exibidas no Painel de Visualização.
PreviewTitle As propriedades são exibidas na área de título do Painel de Visualização ao lado da miniatura do item. O número máximo de entradas é 3. Se a lista de propriedades contiver mais do que o número máximo permitido, o restante das entradas será ignorado.
TileInfo As propriedades são exibidas quando o modo de exibição de lista está no modo de exibição Blocos . O número máximo de entradas é 3. Se a lista de propriedades contiver mais do que o número máximo permitido, o restante das entradas será ignorado. Nota: Esse valor estava presente no Windows XP.
ExtendedTileInfo As propriedades são exibidas para um item quando o modo de exibição de lista está no modo de exibição bloco estendido .
InfoTip As propriedades são exibidas em uma dica de informação quando um usuário passa o mouse sobre um item. Nota: Esse valor estava presente no Windows XP.
Quicktip As propriedades são exibidas quando é difícil recuperar propriedades diretamente de um item, como quando o item deve ser acessado por uma conexão de rede lenta. É recomendável que as propriedades nomeadas aqui, como Tipo ou Tamanho, não exijam a abertura do fluxo de arquivos para determinar seu valor. Nota: Esse valor estava presente no Windows XP.

 

O exemplo a seguir define o valor PreviewDetails para um tipo de arquivo .recipe, usando um ProgID de RecipeKey.

HKEY_CLASSES_ROOT
   .recipe
      (Default) = Recipe File
   RecipeFile
      PreviewDetails = prop:*System.Title;*System.Author

Conforme explicado no tópico associação de arquivo shell, as associações de arquivo podem ser descritas para o formulário mais específico para o formulário mais geral. O formulário mais específico é a extensão de nome de arquivo único e o formulário mais genérico é uma chave que se aplica a todos os arquivos e pastas de arquivo. Entre esses dois extremos, você também pode definir um PROGID que agrupa um conjunto de extensões de nome de arquivo (por exemplo, tipos .jpg e .jpeg agrupados como jpegfile). Ao definir listas de propriedades, você deve defini-las para ProgIDs ou, em alguns casos, extensões de nome de arquivo específicas. Evite depender de entradas amplas, como a chave AllFileSystemObjects .

Noções básicas sobre manipuladores de propriedade

Usando nomes de tipo

Inicializando manipuladores de propriedade

Registrando e distribuindo manipuladores de propriedade

Práticas recomendadas e perguntas frequentes do manipulador de propriedades