Функция SetPixelV

Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz