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

  • Статья

Функция GetPixel извлекает значение красного, зеленого, синего (RGB) цвета пикселя по указанным координатам.

Синтаксис

COLORREF GetPixel(
  [in] HDC hdc,
  [in] int x,
  [in] int y
);

Параметры

[in] hdc

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

[in] x

Координата X в логических единицах пикселя, который требуется проверить.

[in] y

Координата Y в логических единицах пикселя для проверки.

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

Возвращаемое значение — это значение COLORREF , указывающее RGB пикселя. Если пиксель находится за пределами текущей области обрезки, возвращаемое значение CLR_INVALID (0xFFFFFFFF определено в Wingdi.h).

Комментарии

Пиксель должен находиться в пределах текущей области обрезки.

Не все устройства поддерживают GetPixel. Приложение должно вызвать GetDeviceCaps , чтобы определить, поддерживает ли указанное устройство эту функцию.

Растровое изображение должно быть выбрано в контексте устройства, в противном случае CLR_INVALID возвращается во всех пикселях.

Требования

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

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

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

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

COLORREF

GetDeviceCaps

SetPixel