Функция SetPixelV (wingdi.h)

  • Статья

Функция SetPixelV устанавливает пиксель с заданными координатами в ближайшее приближение указанного цвета. Точка должна находиться в области отсечения и видимой части поверхности устройства.

Синтаксис

BOOL SetPixelV(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] x

Координата X (в логических единицах) устанавливаемой точки.

[in] y

Координата Y в логических единицах устанавливаемой точки.

[in] color

Цвет, используемый для закрашивания точки. Чтобы создать значение цвета COLORREF , используйте макрос RGB .

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

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Комментарии

Не все устройства поддерживают функцию SetPixelV . Дополнительные сведения см. в описании возможности RC_BITBLT в функции GetDeviceCaps .

SetPixelV быстрее, чем SetPixel, так как ему не нужно возвращать значение цвета фактически окрашенной точки.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

См. также раздел

Функции точечных рисунков

Общие сведения о точечных изображениях

COLORREF

GetDeviceCaps

RGB

SetPixel