Skip to content

Latest commit

 

History

History
109 lines (73 loc) · 2.94 KB

nf-wingdi-setpixelv.md

File metadata and controls

109 lines (73 loc) · 2.94 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:wingdi.SetPixelV
SetPixelV function (wingdi.h)
The SetPixelV function sets the pixel at the specified coordinates to the closest approximation of the specified color. The point must be in the clipping region and the visible part of the device surface.
SetPixelV
SetPixelV function [Windows GDI]
_win32_SetPixelV
gdi.setpixelv
wingdi/SetPixelV
gdi\setpixelv.htm
gdi
638f0ffd-3771-4390-b335-0517be5312fd
12/05/2018
SetPixelV, SetPixelV function [Windows GDI], _win32_SetPixelV, gdi.setpixelv, wingdi/SetPixelV
wingdi.h
Windows.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Gdi32.lib
Gdi32.dll
Windows
19H1
SetPixelV
wingdi/SetPixelV
c++
APIRef
kbSyntax
DllExport
gdi32.dll
Ext-MS-Win-GDI-Internal-Desktop-L1-1-0.dll
GDI32Full.dll
SetPixelV

SetPixelV function

-description

The SetPixelV function sets the pixel at the specified coordinates to the closest approximation of the specified color. The point must be in the clipping region and the visible part of the device surface.

-parameters

-param hdc [in]

A handle to the device context.

-param x [in]

The x-coordinate, in logical units, of the point to be set.

-param y [in]

The y-coordinate, in logical units, of the point to be set.

-param color [in]

The color to be used to paint the point. To create a COLORREF color value, use the RGB macro.

-returns

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

-remarks

Not all devices support the SetPixelV function. For more information, see the description of the RC_BITBLT capability in the GetDeviceCaps function.

SetPixelV is faster than SetPixel because it does not need to return the color value of the point actually painted.

-see-also

Bitmap Functions

Bitmaps Overview

COLORREF

GetDeviceCaps

RGB

SetPixel