Função PickIconDlg (shlobj_core.h)

  • Artigo

[PickIconDlg está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Exibe uma caixa de diálogo que permite que o usuário escolha um ícone da seleção disponível inserida em um recurso, como um arquivo executável ou DLL.

Sintaxe

int PickIconDlg(
  [in, optional]      HWND  hwnd,
  [in, out]           PWSTR pszIconPath,
                      UINT  cchIconPath,
  [in, out, optional] int   *piIconIndex
);

Parâmetros

[in, optional] hwnd

Digite: HWND

O identificador da janela pai. Esse valor pode ser NULL.

[in, out] pszIconPath

Tipo: PWSTR

Um ponteiro para uma cadeia de caracteres que contém o caminho totalmente qualificado e terminado em nulo do recurso padrão que contém os ícones. Se o usuário escolher um recurso diferente na caixa de diálogo, esse buffer conterá o caminho desse arquivo quando a função retornar. Esse buffer deve ter pelo menos MAX_PATH caracteres de comprimento ou o caminho retornado pode ser truncado. Você deve verificar se o caminho é válido antes de usá-lo.

cchIconPath

Tipo: UINT

O número de caracteres em pszIconPath, incluindo o caractere NULL de terminação.

[in, out, optional] piIconIndex

Tipo: int*

Um ponteiro para um inteiro que na entrada especifica o índice da seleção inicial e, quando essa função retorna com êxito, recebe o índice do ícone selecionado.

Retornar valor

Tipo: int

Retorna 1 se tiver êxito; caso contrário, 0.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h (inclua Shlobj.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 6.0 ou posterior)
Conjunto de APIs ext-ms-win-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240)