Compartilhar via


SetPixel

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa função define o pixel nas coordenadas especificadas para a cor especificada.

Syntax

COLORREF SetPixel(
  HDC hdc, 
  int X, 
  int Y, 
  COLORREF crColor
); 

Parameters

  • hDC
    [no] Identificador para o contexto dispositivo.
  • X
    [no] Especifica o x-coordenar, em unidades lógicas, da apontar a ser definido.
  • Y
    [no] Especifica a y-coordenar, em unidades lógicas, da apontar a ser definido.
  • crColor
    [no] Especifica a cor seja usada para tinta a apontar.

Return Value

O valor RGB que a função define o pixel como indica sucesso.

Este valor pode diferir da cor especificada pelo crColor; que acontece quando uma correspondência exata para a cor especificada não pode ser encontrada.

– 1 Indica falha.

Para informações de erro estendidas get, chamar GetLastError.

Remarks

A função falhará se lie coordenadas de pixel outside of o atual região de recorte.

Nem todos os dispositivos suporte a SetPixel função. Para obter mais informações, consulte GetDeviceCaps.

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

GetDeviceCaps
GDI Functions
COLORREF