Função PickIconDlg (shlobj_core.h)

[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