Функция SetPixel (wingdi.h)
Функция SetPixel задает для пикселя в указанных координатах указанный цвет.
Синтаксис
COLORREF SetPixel(
[in] HDC hdc,
[in] int x,
[in] int y,
[in] COLORREF color
);
Параметры
[in] hdc
Дескриптор контекста устройства.
[in] x
Координата X в логических единицах устанавливаемой точки.
[in] y
Координата Y в логических единицах устанавливаемой точки.
[in] color
Цвет, используемый для закраски точки. Чтобы создать значение цвета COLORREF , используйте макрос RGB .
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение — это RGB-значение, которое функция задает для пикселя. Это значение может отличаться от цвета, заданного crColor; возникает, когда не удается найти точное совпадение для указанного цвета.
Если функция завершается сбоем, возвращается значение -1.
Это может быть следующее значение.
| Код возврата | Описание |
|---|---|
|
Один или несколько входных параметров недопустимы. |
Комментарии
Функция завершается ошибкой, если пиксельные координаты находятся за пределами текущей области обрезки.
Не все устройства поддерживают функцию SetPixel . Дополнительные сведения см. в разделе GetDeviceCaps.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |