Тарас Сорока - Русский справочник по Win32 API
Возвращаемые значения
В случае успеха возвращается текущий графический режим. Он может быть представлен одним из следующих значений:
Значение
Пояснение
GM _ COMPATIBLE
Текущий графический режим является совместимым с Windows 3.1 режимом. В этом графическом режиме приложение не может установить или изменить мировое преобразование ( world transformation ) в указанном контексте устройства. Совместимый режим является графическим режимом по умолчанию.
GM_ADVANCED
Windows NT : Текущий графический режим является расширенным режимом, разрешающим мировые преобразования. В этом графическом режиме приложение может установить или изменить мировое преобразование в указанном контексте устройства. Windows 95: Значение GM _ ADVANCED не поддерживается.
В противном случае, возвращается нуль.
Комментарии
Приложение может установить графический режим для контекста устройства, вызвав функцию SetGraphicsMode .
См. также
SetGraphicsMode .
Буфер обмена
ChangeClipboardChain
Функция ChangeClipboardChain удаляет указанное окно из цепочки просмотра буфера обмена.
BOOL ChangeClipboardChain (
HWND hWndRemove ,
HWND hWndNewNext
);
Параметры
hWndRemove - дескриптор окна, которое будет удалено из цепочки. Дескриптор должен был быть передан в функцию SetClipboardViewer.
hWndNewNext - дескриптор окна, которое следует за окном, определяемым значением параметра hWndRemove, в цепочке просмотра буфера обмена. (Это дескриптор, возвращенный функцией SetClipboardViewer , если только последовательность не была изменена в ответ на сообщение WM_CHANGECBCHAIN .)
Возвращаемые значения
Возвращаемое значение показывает результат передачи сообщения WM_CHANGECBCHAIN окну в цепочке просмотра буфера обмена. Поскольку окно в цепочке типично возвращает FALSE, когда оно обрабатывает сообщение WM_CHANGECBCHAIN, типично возвращаемое функцией ChangeClipboardChain значение - тоже FALSE. Если в цепочке просмотра одно окно - типично возвращается TRUE.
Комментарии
Окно, идентифицируемое значением параметра hWndNewNext, заменяет окно, идентифицируемое значением параметра hWndRemove , в цепочке просмотра. Функция SetClipboardViewer отправляет сообщение WM_CHANGECBCHAIN первому окну в цепочке просмотра буфера обмена.
Требования
Windows NT/2000/XP: Включена в Windows NT 3.1 и выше.
Windows 95/98/Me: Включена в Windows 95 и выше.
Заголовок: Объявлена в Winuser.h ; подключатьWindows.h.
Библиотека: Используйте User32.lib .
См . также
SetClipboardViewer, WM_CHANGECBCHAIN.
CloseClipboard
Функция CloseClipboard закрывает буфер обмена.
BOOL CloseClipboard (VOID)
Параметры
Функция не имеет параметров.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Когда окно закончило проверку или изменение содержимого буфера обмена, закройте его, вызвав CloseClipboard . Это позволит другим окнам получить доступ к буферу обмена.
Не помещайте объект в буфер обмена после вызова CloseClipboard .
См. также
GetOpenClipboardWindow, OpenClipboard .
CountClipboardFormats
Функция CountClipboardFormats извлекает число различных форматов данных в буфере обмена в настоящий момент
int CountClipboardFormats ( VOID )
Параметры
Функция не имеет параметров.
Возвращаемые значения
В случае успеха возвращается количество различных форматов данных в буфере обмена в настоящий момент.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
См. также
EnumClipboardFormats, RegisterClipboardFormat .
GetClipboardFormatName
Функция GetClipboardFormatName извлекает из буфера обмена имя указанного зарегистрированного формата. Функция копирует имя в указанный буфер.
int GetClipboardFormatName (
UINT format , // извлекаемый формат буфера обмена
LPTSTR lpszFormatName , // адрес буфера для имени
int cchMaxCount // длина строки имени в символах
);
Параметры
format - определяет тип извлекаемого формата. Значение этого параметра не должно указывать на один из ранее предопределенных форматов.
lpszFormatName - указывает на буфер, который получает имя формата.
cchMaxCount - определяет максимальную длину строки, скопированной в буфер, в символах. Если имя превышает этот предел, лишние символы строки отбрасываются.
Возвращаемые значения
В случае успеха возвращается длина скопированной в буфер строки в символах.
В случае неудачи возвращается нуль, указывая, что затребованный формат не существует или является ранее предопределенным форматом. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
См. также
EnumClipboardFormats, RegisterClipboardFormat .
GetClipboardOwner
Функция GetClipboardOwner извлекает дескриптор окна, являющегося текущим владельцем буфера обмена.
HWND GetClipboardOwner ( VOID )
Параметры
Функция не имеет параметров.
Возвращаемые значения
В случае успеха возвращается дескриптор окна, которое владеет буфером обмена.
В случае неудачи возвращается NULL . Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Буфер обмена может содержать данные, даже если им в настоящий момент никто не владеет.
В общем, владельцем буфера обмена является окно, которое последним поместило данные в него. Функция EmptyClipboard назначает владение буфером обмена.
См. также
EmptyClipboard, GetClipboardViewer .
Время
CompareFileTime
Функция CompareFileTime сравнивает два 64-битных файловых времени.
LONG CompareFileTime (
CONST FILETIME * lpFileTime1 , // pointer to first file time
CONST FILETIME * lpFileTime2 // pointer to second file time
);
Параметры
lpFileTime 1 - указывает на структуру типа FILETIME , которая определяет первое 64-битное файловое время.
lpFileTime 2 - указывает на структуру типа FILETIME , которая определяет второе 64-битное файловое время.
Возвращаемые значения
В случае успеха возвращается одно из следующих значений:
Значение
Пояснение
-1
Первое время меньше второго.
0
Времена равны.
+1
Первое время больше второго.
См. также
GetFileTime, FILETIME .
GetFileTime
Функция GetFileTime извлекает дату и время файла, когда он был создан, когда к нему последний раз обращались, и когда он последний раз был изменен.
BOOL GetFileTime (
HANDLE hFile , // идентифицирует файл
LPFILETIME lpCreationTime , // адрес времени создания файла
LPFILETIME lpLastAccessTime , // адрес времени последнего доступа
// к файлу
LPFILETIME lpLastWriteTime // адрес времени последней записи в файл
);
Параметры
hFile - идентифицирует файл, для которого извлекаются дата и время. Файловый дескриптор должен быть создан с доступом GENERIC_READ к файлу.
lpCreationTime - указывает на структуру типа FILETIME , которая получает дату и время создания файла. Значение этого параметра может быть равно NULL, если приложению не требуется эта информация.
lpLastAccessTime - указывает на структуру типа FILETIME , которая получает дату и время последнего доступа к файлу. Время последнего доступа включает в себя время, когда в последний раз: в файл записывалась информация, читалась информация из файла, или, в случае исполняемых файлов, файл запускался на исполнение. Значение этого параметра может быть равно NULL, если приложению не требуется эта информация.
