Функция SetPixelV устанавливает пиксель в заданных координатах в самом близком приближении к заданному цвету. Точка должна быть в области прорисовки и в видимой части поверхности устройства.
Синтаксис
BOOL SetPixelV( HDC hdc, // дескриптор контекста устройства int X, // x-координата пикселя int Y, // y-координата пикселя COLORREF crColor // новый цвет пикселя ); |
Параметры
hdc
[in] Дескриптор контекста устройства.X
[in] Определяет x-координату устанавливаемой точки, в логических единицах.Y
[in] Определяет y-координату устанавливаемой точки, в логических единицах.crColor
[in] Устанавливает цвет, используемый для рисования точки. Чтобы создать код цвета COLORREF, используйте макрокоманду RGB.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается с ошибкой, возвращаемое значение - нуль.
Windows NT/2000/XP: Чтобы получать дополнительные сведения об ошибке, вызовите GetLastError.
Замечания
Не все устройства поддерживают функцию SetPixelV. Подробную информацию, см. в описании флажка RC_BITBLT в функции GetDeviceCaps.
Функция SetPixelV быстрее чем SetPixel, потому что ей не нужно возвращать значение кода цвета точки, которым она фактически рисуется.
Смотри также
Обзор Точечные рисунки, Функции, используемые точечными рисунками, GetDeviceCaps, SetPixel, COLORREF, RGB
|
Размещение и совместимость SetPixelV |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Gdi32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Wingdi.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |