Пространство имен оболочки
Функция BrowseCallbackProc представляет собой определяемую приложением функцию обратного вызова, используемую совместно с функцией SHBrowseForFolder . Диалоговое окно выбора папки вызывает эту функцию для уведомления о событиях. Тип BFFCALLBACK определяет указатель на эту функцию обратного вызова.
int BrowseCallbackProc (
HWND hwnd ,
UINT uMsg ,
LPARAM lParam ,
LPARAM lpData
);
Параметры
hwnd - дескриптор диалогового окна. Функция обратного вызова может отправлять окну следующие сообщения:
BFFM_ENABLEOK | Разрешает кнопку ОК, если значение параметра wParam не равно нулю. В противном случае запрещает кнопку ОК. |
BFFM_SETSELECTION | Выбирает указанную папку. Значение lParam представляет собой PIDL выбираемой папки, если значение wParam равно FALSE, или путь папки в противном случае. |
BFFM _ SETSTATUSTEXT | Устанавливает текст состояния в завершающуюся нулем строку, определенную значением параметра lParam . |
uMsg - идентифицирует событие. Может принимать одно из следующих значений:
BFFM_INITIALIZED | Диалоговое окно завершило инициализацию. Значение параметра lpData равно NULL . |
BFFM_SELCHANGED | Изменился выбор в диалоговом окне. lpData представляет собой указатель на список идентификаторов элемента для выбранной папки. |
lParam - зависящее от сообщения значение.
lpData - определяемое приложением значение, которое было указано в члене lParam структуры типа BROWSEINFO .
Возвращаемые значения
Функция возвращает нуль.
См. также
BROWSEINFO .
Добавляет документ в список недавно использовавшихся документов или очищает список. Пользователь может получить доступ к списку через меню Пуск ( Start ) панели задач Windows .
WINSHELLAPI void WINAPI SHAddToRecentDocs (
UINT uFlags ,
LPCVOID pv
);
Параметры
uFlags - флаг, определяющий значение параметра pv . Может принимать одно из следующих значений:
SHARD_PATH - pv является адресом строки, содержащей путь и имя файла;
SHARD_PIDL - pv является адресом списка идентификаторов элемента.
pv - указатель на буфер, содержащий путь и имя файла документа, или адрес структуры ITEMIDLIST , содержащей список идентификаторов элемента, однозначно определяющих документ. Если значение этого параметр равно NULL, то функция очищает список недавно использовавшихся документов.
Возвращаемые значения
Функция не возвращает значения.
Функция SHBrowseForFolder отображает диалоговое окно, позволяющее пользователю выбрать папку пространства имен.
WINSHELLAPI LPITEMIDLIST WINAPI SHBrowseForFolder (
LPBROWSEINFO lpbi
);
Параметры
lpbi - указатель на структуру типа BROWSEINFO , которая содержит информацию, используемую для отображения диалогового окна.
Возвращаемые значения
Возвращается указатель на список идентификаторов элементов, который определяет местоположение выбранной папки относительно корня пространства имен. Если пользователь в диалоговом окне нажал клавишу Cancel, возвращается NULL .
Вызывающее приложение ответственно за освобождение возвращаемого списка идентификаторов.
См. также
BROWSEINFO.
Выполняет операцию копирования, перемещения, переименования или удаления над объектом файловой системы.
WINSHELLAPI int WINAPI SHFileOperation (
LPSHFILEOPSTRUCT lpFileOp
);
Параметры
lpFileOp - указатель на структуру типа SHFILEOPSTRUCT , содержащую информацию, необходимую функции для выполнения операции.
Возвращаемые значения
В случае успеха возвращается нуль, ненулевое значение в противном случае.
См. также
SHFILEOPSTRUCT.
Освобождает объект отображения имени файла (filename mapping object), извлекаемый функцией SHFileOperation .
WINSHELLAPI void WINAPI SHFreeNameMappings (
HANDLE hNameMappings
);
Параметры
hNameMappings - дескриптор освобождаемого объекта отображения имени файла.
Возвращаемые значения
Функция не возвращает значения.
Функция SHGetDesktopFolder возвращает интерфейс IShellFolder для папки рабочего стола, которая является корнем пространства имен пользовательского интерфейса ( shell ).
