Compartilhar via


Interface ICustomDestinationList (shobjidl_core.h)

Expõe métodos que permitem que um aplicativo forneça uma Lista de Saltos personalizada, incluindo destinos e tarefas, para exibição na barra de tarefas.

Herança

A interface ICustomDestinationList herda da interface IUnknown . ICustomDestinationList também tem estes tipos de membros:

Métodos

A interface ICustomDestinationList tem esses métodos.

 
ICustomDestinationList::AbortList

Descontinua uma sessão de construção da Lista de Saltos iniciada por ICustomDestinationList::BeginList sem confirmar nenhuma alteração.
ICustomDestinationList::AddUserTasks

Especifica itens a serem incluídos na categoria Tarefas de uma Lista de Saltos personalizada.
ICustomDestinationList::AppendCategory

Define uma categoria personalizada e os destinos que ela contém, para inclusão em uma Lista de Saltos personalizada.
ICustomDestinationList::AppendKnownCategory

Especifica que a categoria Frequente ou Recente deve ser incluída em uma Lista de Saltos personalizada.
ICustomDestinationList::BeginList

Inicia uma sessão de construção para uma Lista de Saltos personalizada.
ICustomDestinationList::CommitList

Declara que a Lista de Saltos iniciada por uma chamada para ICustomDestinationList::BeginList está concluída e pronta para exibição.
ICustomDestinationList::D eleteList

Exclui uma Lista de Saltos personalizada para um aplicativo especificado.
ICustomDestinationList::GetRemovedDestinations

Recupera a lista atual de destinos que foram removidos pelo usuário da Lista de Saltos existente que esta Lista de Saltos personalizada deve substituir.
ICustomDestinationList::SetAppID

Especifica uma ID exclusiva do Modelo de Usuário do Aplicativo (AppUserModelID) para o aplicativo cujo botão de barra de tarefas manterá a Lista de Saltos personalizada criada por meio dos métodos dessa interface. Esse método é opcional.

Comentários

Quando implementar

Uma implementação dessa interface é fornecida no Windows como CLSID_DestinationList. Essa interface não é implementada por terceiros.

Quando usar

As Listas de salto contêm listas de destino e de tarefas.
  • Destinos são itens que aparecem nas categorias Recentes, Frequentes ou personalizadas, com base no uso de um indivíduo. Os destinos podem ser arquivos, pastas, sites ou outros itens baseados em conteúdo, mas não são necessariamente apoiados por arquivos. Os destinos podem ser considerados como coisas ou substantivos. Os destinos podem ser fixados ou removidos da Lista de Saltos pelo usuário. Eles geralmente são representados por objetos IShellItem , mas também podem ser objetos IShellLink .
  • Tarefas são ações comuns executadas em um aplicativo que se aplicam a todos os usuários desse aplicativo, independentemente dos padrões de uso de um indivíduo. As tarefas podem ser consideradas como ações ou verbos. As tarefas não podem ser fixadas ou removidas. Eles são representados por objetos IShellLink .

A barra de tarefas fornece cada botão de barra de tarefas com uma Lista de Saltos. Por padrão, uma Lista de Saltos contém uma categoria Recente , que é preenchida automaticamente para aplicativos baseados em arquivo por meio de SHAddToRecentDocs ou da caixa de diálogo de arquivo comum. Para substituir a categoria Recent pela categoria Frequente ou definir, adicionar e preencher suas próprias categorias personalizadas, um aplicativo deve chamar os métodos dessa interface. O aplicativo também pode fornecer suas próprias tarefas com base na arquitetura do aplicativo e no uso pretendido.

Nota Um aplicativo deve ser um manipulador registrado para um tipo de arquivo para que um item desse tipo apareça em sua Lista de Saltos. No entanto, ele não precisa ser o manipulador padrão para esse tipo de arquivo.
 
Uma Lista de Saltos personalizada destina-se a apresentar conteúdo que o aplicativo considerou significativo com base no uso anterior do aplicativo ou por meio de uma ação que indicou que um item é importante para o usuário, como o usuário adicionando um item a uma lista favoritos.

O aplicativo deve chamar esse objeto para fornecer uma Lista de Saltos personalizada para a interface do usuário da barra de tarefas. O sistema nunca consulta o aplicativo para obter as informações.

Quando um aplicativo fornece uma Lista de Saltos personalizada, ele assume determinadas responsabilidades em torno dessa lista. As categorias personalizadas devem ser preenchidas de maneira consistente com o uso pretendido de uma Lista de Saltos. Os itens na lista devem ser verificados quanto à validade ou falhar normalmente se tiverem sido excluídos. Se o usuário remover um item da lista, essa remoção deverá ser respeitada.

Uma Lista de Saltos personalizada nunca é realmente atualizada no sentido de alterar elementos em uma lista existente. Em vez disso, a lista antiga é substituída por uma nova lista.

A sequência básica de chamadas de método ICustomDestinationList para compilar e exibir uma Lista de Saltos personalizada é a seguinte:

  1. SetAppID (necessário somente se um aplicativo fornecer seu próprio AppUserModelID)
  2. BeginList
  3. AppendCategory, AppendKnownCategory, AddUserTasks ou qualquer combinação desses três métodos.
  4. CommitList

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

Extensões da barra de tarefas