Русский справочник по Win32 API - Тарас Сорока

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 .

SHAddToRecentDocs

Добавляет документ в список недавно использовавшихся документов или очищает список. Пользователь может получить доступ к списку через меню Пуск ( Start ) панели задач Windows .

WINSHELLAPI void WINAPI SHAddToRecentDocs (

UINT uFlags ,

LPCVOID pv

);

Параметры

uFlags - флаг, определяющий значение параметра pv . Может принимать одно из следующих значений:

SHARD_PATH - pv является адресом строки, содержащей путь и имя файла;

SHARD_PIDL - pv является адресом списка идентификаторов элемента.

pv - указатель на буфер, содержащий путь и имя файла документа, или адрес структуры ITEMIDLIST , содержащей список идентификаторов элемента, однозначно определяющих документ. Если значение этого параметр равно NULL, то функция очищает список недавно использовавшихся документов.

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

Функция не возвращает значения.

SHBrowseForFolder

Функция SHBrowseForFolder отображает диалоговое окно, позволяющее пользователю выбрать папку пространства имен.

WINSHELLAPI LPITEMIDLIST WINAPI SHBrowseForFolder (

LPBROWSEINFO lpbi

);

Параметры

lpbi - указатель на структуру типа BROWSEINFO , которая содержит информацию, используемую для отображения диалогового окна.

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

Возвращается указатель на список идентификаторов элементов, который определяет местоположение выбранной папки относительно корня пространства имен. Если пользователь в диалоговом окне нажал клавишу Cancel, возвращается NULL .

Вызывающее приложение ответственно за освобождение возвращаемого списка идентификаторов.

См. также

BROWSEINFO.

SHFileOperation

Выполняет операцию копирования, перемещения, переименования или удаления над объектом файловой системы.

WINSHELLAPI int WINAPI SHFileOperation (

LPSHFILEOPSTRUCT lpFileOp

);

Параметры

lpFileOp - указатель на структуру типа SHFILEOPSTRUCT , содержащую информацию, необходимую функции для выполнения операции.

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

В случае успеха возвращается нуль, ненулевое значение в противном случае.

См. также

SHFILEOPSTRUCT.

SHFreeNameMappings

Освобождает объект отображения имени файла (filename mapping object), извлекаемый функцией SHFileOperation .

WINSHELLAPI void WINAPI SHFreeNameMappings (

HANDLE hNameMappings

);

Параметры

hNameMappings - дескриптор освобождаемого объекта отображения имени файла.

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

Функция не возвращает значения.

SHGetDesktopFolder

Функция SHGetDesktopFolder возвращает интерфейс IShellFolder для папки рабочего стола, которая является корнем пространства имен пользовательского интерфейса ( shell ).

WINSHELLAPI HRESULT WINAPI SHGetDesktopFolder (

LPSHELLFOLDER *ppshf

);

Параметры

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

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

В случае успеха возвращает NOERROR или OLE -определенную ошибку в противном случае.

См. также

IShellFolder .

SHGetInstanceExplorer

Функция SHGetInstanceExplorer извлекает адрес интерфейса IUnknown Explorer'а ( Проводника ).

WINSHELLAPI HRESULT WINAPI SHGetInstanceExplorer (

IUnknown * ppunk

);

Параметры

ppunk - указатель на переменную, получающую адрес интерфейса IUnknown Explorer 'а.

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

В случае успеха возвращается NOERROR .

В случае неудачи возвращается E _ FAIL .

SHGetMalloc

Функция SHGetMalloc извлекает указатель на интерфейс IMalloc оболочки. Расширение оболочки должно использовать этот интерфейс для выделения памяти, позднее освобождаемой оболочкой.

HRESULT SHGetMalloc (

LPMALLOC * ppMalloc

);

Параметры

ppMalloc - адрес переменной, которая получает адрес интерфейса IMalloc оболочки.

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

В случае успеха возвращается NOERROR или E _ FAIL в противном случае.

SHLoadInProc

Функция SHLoadInProc создает экземпляр указанного класса объекта внутри контекста процесса пользовательского интерфейса.

WINSHELLAPI HRESULT WINAPI SHLoadInProc (

REFCLSID rclsid

);

Параметры

rclsid - CLSID класса объекта, экземпляр которого создается.

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

В случае успеха возвращает NOERROR или OLE -определенную ошибку в противном случае.

Контекст устройства

CancelDC

Функция CancelDC отменяет любую незаконченную операцию на указанном контексте устройства.

BOOL CancelDC (

HDC hdc // дескриптор контекста устройства

);

Параметры

hdc - идентифицирует контекст устройства.

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

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль.

Комментарии

Функция CancelDC используется многопоточными приложениями для отмены протяженных во времени операций рисования. Если поток A инициирует такую операцию рисования, поток В может ее отменить, вызвав эту функцию.

Результаты не определены, если во время вызова этой функции не было выполняющейся операции рисования.

См. также

CreateThread, GetCurrentThread .

CreateCompatibleDC

Функция CreateCompatibleDC создает контекст устройства в памяти, совместимый с указанный контекстом.

HDC CreateCompatibleDC (

HDC hdc // дескриптор контекста устройства

);

Параметры

hdc - идентифицирует контекст устройства. Если значение этого параметра равно NULL, функция создает контекст устройства в памяти, совместимый с текущим экраном приложения.

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

В случае успеха возвращается дескриптор контекста устройства в памяти.

В случае неудачи возвращается NULL .

Комментарии

Перед тем, как приложение сможет использовать контекст устройства в памяти для операций рисования, оно должно выбрать в контекст устройства битовый образ с корректной шириной и высотой. Как только битовый образ выбран, контекст устройства может быть использован для подготовки изображений, которые будут скопированы на экран или принтер.