Функция 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 |
Нет |
|
Замечания по платформе |
Не имеется |