Функция SetPixel


Функция SetPixel устанавливает пиксель в заданных координатах в заданном цвете.

Синтаксис

COLORREF SetPixel(
  HDC hdc,           // дескриптор DC
  int X,             // x-координата пикселя
  int Y,             // y-координата пикселя
  COLORREF crColor   // цвет пикселя
);

Параметры

hdc

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

X

[in] Определяет x-координату устанавливаемой точки, в логических единицах.

Y

[in] Определяет y-координату устанавливаемой точки, в логических единицах.

crColor

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

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

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

Если функция завершается с ошибкой, возвращаемое значение равно -(минус)1.

Windows NT/2000/XP: Чтобы получать дополнительные сведения об ошибке, вызовите GetLastError. Это может быть значением следующим ниже.

Значение Предназначение
ERROR_INVALID_PARAMETER Один или несколько введенных параметров неправильные.
 

Замечания

Функция завершается ошибкой, если координаты пикселя лежат вне текущего региона отсечения (области прорисовки).

Не все устройства поддерживают функцию SetPixel. Подробную информацию, см. в статье о функции  GetDeviceCaps.

Смотри также 

Обзор Точечные рисунки, Функции, используемые точечными рисункамиGetDeviceCaps, GetPixel, SetPixelV, COLORREF, RGB

Размещение и совместимость SetPixel

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