Método IFileDialog::SetFolder (shobjidl_core.h)

Define uma pasta que sempre é selecionada quando a caixa de diálogo é aberta, independentemente da ação anterior do usuário.

Sintaxe

HRESULT SetFolder(
  [in] IShellItem *psi
);

Parâmetros

[in] psi

Tipo: IShellItem*

Um ponteiro para a interface que representa a pasta.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa pasta substitui qualquer pasta "usada mais recentemente". Se esse método for chamado enquanto a caixa de diálogo for exibida, ele fará com que a caixa de diálogo navegue até a pasta especificada.

Em geral, não recomendamos o uso desse método. Se você chamar SetFolder antes de exibir a caixa de diálogo, o local mais recente em que o usuário salvou ou abriu não será mostrado. A menos que haja um motivo muito específico para esse comportamento, não é uma experiência de usuário boa ou esperada e, portanto, deve ser evitada. Em quase todas as instâncias, IFileDialog::SetDefaultFolder é o melhor método.

A partir do Windows 7, se o caminho da pasta especificada por meio do psi for o caminho padrão de uma pasta conhecida, o caminho atual da pasta conhecida será usado na caixa de diálogo. Esse caminho pode não ser o mesmo que o caminho especificado em psi; por exemplo, se a pasta conhecida tiver sido redirecionada. Se a pasta conhecida for uma biblioteca (pastas virtuais Documentos, Músicas, Imagens e Vídeos), o caminho da biblioteca será usado na caixa de diálogo. Se a biblioteca especificada estiver oculta (como são por padrão a partir de Windows 8.1), o local de salvamento padrão da biblioteca será usado na caixa de diálogo, como a pasta Documentos do Microsoft OneDrive para a biblioteca de Documentos. Devido a esses mapeamentos, o local da pasta usado na caixa de diálogo pode não ser exatamente como você especificou quando chamou esse método.

Requisitos

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