Поделиться через

Функция PickIconDlg (shlobj_core.h)

  • Статья

[PickIconDlg доступен для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Отображает диалоговое окно, позволяющее пользователю выбрать значок из выделенного фрагмента, внедренного в такой ресурс, как исполняемый файл или DLL-файл.

Синтаксис

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

Параметры

[in, optional] hwnd

Тип: HWND

Дескриптор родительского окна. Это значение может иметь значение NULL.

[in, out] pszIconPath

Тип: PWSTR

Указатель на строку, содержащую полный путь к ресурсу по умолчанию, который содержит значки, завершающийся null. Если пользователь выбирает другой ресурс в диалоговом окне, этот буфер содержит путь к этому файлу при возврате функции. Длина этого буфера должна быть не менее MAX_PATH символов, иначе возвращаемый путь может быть усечен. Прежде чем использовать путь, убедитесь, что путь является допустимым.

cchIconPath

Тип: UINT

Количество символов в pszIconPath, включая завершающий символ NULL .

[in, out, optional] piIconIndex

Тип: int*

Указатель на целое число, которое в записи указывает индекс начального выбора и, когда эта функция возвращается успешно, получает индекс выбранного значка.

Возвращаемое значение

Тип: int

Возвращает значение 1 в случае успешного выполнения; в противном случае — 0.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlobj_core.h (включая Shlobj.h)
Библиотека Shell32.lib
DLL Shell32.dll (версия 6.0 или более поздняя)
Набор API ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240)