Bitmap ::SetPixel, méthode (gdiplusheaders.h)
La méthode Bitmap ::SetPixel définit la couleur d’un pixel spécifié dans cette bitmap.
Syntaxe
Status SetPixel(
[in] INT x,
[in] INT y,
[in, ref] const Color & color
);
Paramètres
[in] x
Type : INT
int qui spécifie la coordonnée x (colonne) du pixel.
[in] y
Type : INT
int qui spécifie la coordonnée y (ligne) du pixel.
[in, ref] color
Type : couleur const
Référence à un objet Color qui spécifie la couleur à définir.
Valeur retournée
Type : État
Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .
Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .
Remarques
Selon le format de la bitmap, Bitmap ::GetPixel peut ne pas retourner la même valeur que celle définie par Bitmap ::SetPixel. Par exemple, si vous appelez Bitmap ::SetPixel sur un objet Bitmap dont le format de pixel est 32bppPARGB, les composants RVB sont prémultipliés. Un appel suivant à Bitmap ::GetPixel peut retourner une valeur différente en raison de l’arrondi. En outre, si vous appelez Bitmap ::SetPixel sur un bitmap dont la profondeur de couleur est de 16 bits par pixel, des informations peuvent être perdues dans la conversion de 32 à 16 bits, et un appel ultérieur à Bitmap ::GetPixel peut retourner une valeur différente.
Exemples
L’exemple suivant crée un objet Bitmap basé sur un fichier JPEG. Le code dessine la bitmap une fois inchangée. Ensuite, le code appelle la méthode Bitmap ::SetPixel pour créer un modèle à damer de pixels noirs dans la bitmap et dessiner la bitmap modifiée.
VOID Example_SetPixel(HDC hdc)
{
Graphics graphics(hdc);
// Create a Bitmap object from a JPEG file.
Bitmap myBitmap(L"Climber.jpg");
// Draw the bitmap.
graphics.DrawImage(&myBitmap, 0, 0);
// Create a checkered pattern with black pixels.
for (UINT row = 0; row < myBitmap.GetWidth(); row += 2)
{
for (UINT col = 0; col < myBitmap.GetHeight(); col += 2)
{
myBitmap.SetPixel(row, col, Color(255, 0, 0, 0));
}
}
// Draw the altered bitmap.
graphics.DrawImage(&myBitmap, 200, 0);
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | gdiplusheaders.h (inclure Gdiplus.h) |
| Bibliothèque | Gdiplus.lib |
| DLL | Gdiplus.dll |