Interface IShellFolder (shobjidl_core.h)

Expostos por todos os objetos de pasta de namespace do Shell, seus métodos são usados para gerenciar pastas.

Herança

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

Métodos

A interface IShellFolder tem esses métodos.

IShellFolder::BindToObject Recupera um manipulador, normalmente o objeto de pasta Shell que implementa IShellFolder para um item específico. Parâmetros opcionais que controlam a construção do manipulador são passados no contexto de associação.
IShellFolder::BindToStorage Solicita um ponteiro para a interface de armazenamento de um objeto.
IShellFolder::CompareIDs Determina a ordem relativa de dois objetos ou pastas de arquivo, considerando suas listas de identificadores de item.
IShellFolder::CreateViewObject Solicita um objeto que pode ser usado para obter informações ou interagir com um objeto de pasta.
IShellFolder::EnumObjects Permite que um cliente determine o conteúdo de uma pasta criando um objeto de enumeração de identificador de item e retornando sua interface IEnumIDList. Os métodos compatíveis com essa interface podem ser usados para enumerar o conteúdo da pasta.
IShellFolder::GetAttributesOf Obtém os atributos de um ou mais objetos de arquivo ou pasta contidos no objeto representado por IShellFolder.
IShellFolder::GetDisplayNameOf Recupera o nome de exibição do objeto de arquivo ou subpasta especificado.
IShellFolder::GetUIObjectOf Obtém um objeto que pode ser usado para executar ações nos objetos ou pastas de arquivo especificados.
IShellFolder::P arseDisplayName Converte o nome de exibição de um objeto de arquivo ou uma pasta em uma lista de identificadores de item.
IShellFolder::SetNameOf Define o nome de exibição de um objeto de arquivo ou subpasta, alterando o identificador de item no processo.

Comentários

Implemente essa interface para objetos que estendem o namespace do Shell. Por exemplo, implemente essa interface para criar um namespace separado que exija um windows Explorer raiz ou para instalar um novo namespace diretamente dentro da hierarquia do namespace do sistema. Você está mais familiarizado com o conteúdo do namespace, portanto, é responsável por implementar tudo o que é necessário para acessar seus dados.

Use essa interface quando precisar exibir ou executar uma operação no conteúdo do namespace do Shell. Objetos que dão suporte a IShellFolder geralmente são criados por outros objetos de pasta shell. Para recuperar a interface IShellFolder de uma pasta, você normalmente começa chamando SHGetDesktopFolder. Essa função retorna um ponteiro para a interface IShellFolder da área de trabalho. Em seguida, você pode usar seus métodos para recuperar uma interface IShellFolder para uma pasta de namespace específica.

Observe que os métodos IShellFolder aceitam apenas PIDLs relativos à pasta. Alguns métodos IShellFolder , como IShellFolder::GetAttributesOf, aceitam apenas PIDLs de nível único. Em outras palavras, o PIDL deve conter apenas uma única estrutura SHITEMID , além do NULL de terminação. Ao enumerar o conteúdo de uma pasta com IEnumIDList, você receberá PIDLs desse formulário. Outros métodos, como IShellFolder::CompareIDs, aceitam PIDLs de vários níveis. Esses PIDLs podem ter várias estruturas SHITEMID e identificar objetos um ou mais níveis abaixo da pasta pai. Verifique a referência para ter certeza de que tipo de PIDL pode ser aceito por um método específico.

 

Exemplos

Uma implementação de exemplo de IShellFolder pode ser vista no exemplo de exemplo do provedor de dados Explorer. O uso de vários métodos IShellFolder pode ser encontrado em vários exemplos, incluindo Exemplo de Operações de Arquivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h