Método IFileOpenDialog::GetSelectedItems (shobjidl_core.h)

Obtém os itens selecionados no momento na caixa de diálogo. Esses itens podem ser itens selecionados na exibição ou texto selecionado na caixa de edição nome do arquivo.

Sintaxe

HRESULT GetSelectedItems(
  [out] IShellItemArray **ppsai
);

Parâmetros

[out] ppsai

Tipo: IShellItemArray**

O endereço de um ponteiro para um IShellItemArray por meio do qual os itens selecionados podem ser acessados.

Valor retornado

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

Esse método pode ser usado para seleções de item único ou vários itens. Se o usuário tiver inserido um novo texto no campo nome do arquivo, essa poderá ser uma operação demorada. Quando o aplicativo chama esse método, o aplicativo analisa o texto no filename campo . Por exemplo, se esse for um compartilhamento de rede, a operação poderá levar algum tempo. No entanto, essa operação não bloqueará a interface do usuário, pois o usuário deve conseguir interromper a operação, o que resultará em IFileOpenDialog::GetSelectedItems retornando um código de falha).

Requisitos