Color.FromArgb Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Primitives.dll

Crée une structure Color à partir des quatre composants ARGB 8 bits (alpha, rouge, vert et bleu).

Surcharges

FromArgb(Int32, Int32, Int32, Int32)	Crée une structure Color à partir des quatre valeurs de composant ARGB (alpha, rouge, vert et bleu). Bien que cette méthode autorise la transmission d’une valeur 32 bits pour chaque composant, la valeur de chaque composant est limitée à 8 bits.
FromArgb(Int32, Int32, Int32)	Crée une structure Color à partir des valeurs de couleur 8 bits spécifiées (rouge, vert et bleu). La valeur alpha est implicitement 255 (entièrement opaque). Bien que cette méthode autorise la transmission d’une valeur 32 bits pour chaque composant de couleur, la valeur de chaque composant est limitée à 8 bits.
FromArgb(Int32, Color)	Crée une structure Color à partir de la structure Color spécifiée, mais avec la nouvelle valeur alpha spécifiée. Bien que cette méthode autorise la transmission d’une valeur 32 bits pour la valeur alpha, la valeur est limitée à 8 bits.
FromArgb(Int32)	Crée une structure Color à partir d’une valeur ARVB 32 bits.

FromArgb(Int32, Int32, Int32, Int32)

Source:

Color.cs

Crée une structure Color à partir des quatre valeurs de composant ARGB (alpha, rouge, vert et bleu). Bien que cette méthode autorise la transmission d’une valeur 32 bits pour chaque composant, la valeur de chaque composant est limitée à 8 bits.

C#

public static System.Drawing.Color FromArgb (int alpha, int red, int green, int blue);

Paramètres

alpha

Int32

Composant alpha. Les valeurs valides sont comprises entre 0 et 255.

red

Int32

Composant rouge. Les valeurs valides sont comprises entre 0 et 255.

green

Int32

Composant vert. Les valeurs valides sont comprises entre 0 et 255.

blue

Int32

Composant bleu. Les valeurs valides sont comprises entre 0 et 255.

Retours

Color

La Color créée par cette méthode.

Exceptions

ArgumentException

alpha, red, greenou blue est inférieur à 0 ou supérieur à 255.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

• Crée trois pinceaux, chacun une couleur différente. Chaque structure Color utilisée pour créer un pinceau est créée à partir de quatre valeurs de composant (alpha, rouge, vert, bleu).

• Utilise un triangle imaginaire pour positionner trois cercles.

• Peint trois cercles qui se chevauchent, chacun centré sur un sommet du triangle, à l’aide d’un pinceau différent pour chaque cercle.

C#

public void FromArgb1(PaintEventArgs e)
{
    Graphics     g = e.Graphics;
             
    // Transparent red, green, and blue brushes.
    SolidBrush trnsRedBrush = new SolidBrush(Color.FromArgb(120, 255, 0, 0));
    SolidBrush trnsGreenBrush = new SolidBrush(Color.FromArgb(120, 0, 255, 0));
    SolidBrush trnsBlueBrush = new SolidBrush(Color.FromArgb(120, 0, 0, 255));
             
    // Base and height of the triangle that is used to position the
    // circles. Each vertex of the triangle is at the center of one of the
    // 3 circles. The base is equal to the diameter of the circles.
    float   triBase = 100;
    float   triHeight = (float)Math.Sqrt(3*(triBase*triBase)/4);
             
    // Coordinates of first circle's bounding rectangle.
    float   x1 = 40;
    float   y1 = 40;
             
    // Fill 3 over-lapping circles. Each circle is a different color.
    g.FillEllipse(trnsRedBrush, x1, y1, 2*triHeight, 2*triHeight);
    g.FillEllipse(trnsGreenBrush, x1 + triBase/2, y1 + triHeight,
        2*triHeight, 2*triHeight);
    g.FillEllipse(trnsBlueBrush, x1 + triBase, y1, 2*triHeight, 2*triHeight);
}

Remarques

Pour créer une couleur opaque, définissez alpha sur 255. Pour créer une couleur semi-transparente, définissez alpha sur n’importe quelle valeur comprise entre 1 et 254.

FromArgb(Int32, Int32, Int32)

Source:

Color.cs

Crée une structure Color à partir des valeurs de couleur 8 bits spécifiées (rouge, vert et bleu). La valeur alpha est implicitement 255 (entièrement opaque). Bien que cette méthode autorise la transmission d’une valeur 32 bits pour chaque composant de couleur, la valeur de chaque composant est limitée à 8 bits.

C#

public static System.Drawing.Color FromArgb (int red, int green, int blue);

Paramètres

red

Int32

Valeur du composant rouge pour la nouvelle Color. Les valeurs valides sont comprises entre 0 et 255.

green

Int32

Valeur du composant vert pour la nouvelle Color. Les valeurs valides sont comprises entre 0 et 255.

blue

Int32

Valeur du composant bleu pour la nouvelle Color. Les valeurs valides sont comprises entre 0 et 255.

Retours

Color

La Color créée par cette méthode.

Exceptions

ArgumentException

red, greenou blue est inférieur à 0 ou supérieur à 255.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

1. Crée Color structures à partir des trois valeurs du composant de couleur (rouge, vert, bleu). Trois structures Color sont créées, une pour chaque couleur primaire.

2. Itère à travers une plage de valeurs alpha, en modifiant la valeur alpha d’une couleur.

3. Pendant chaque itération, définit la couleur d’un pinceau sur la couleur modifiée et peint un rectangle pour afficher la couleur.

4. Répète les étapes 2 et 3 pour chaque couleur primaire.

La valeur alpha n’est jamais entièrement opaque et les rectangles se chevauchent afin d’obtenir des effets de combinaison de couleurs.

C#

public void FromArgb2(PaintEventArgs e)
{
    Graphics     g = e.Graphics;
             
    // Opaque colors (alpha value defaults to 255 -- max value).
    Color red = Color.FromArgb(255, 0, 0);
    Color green = Color.FromArgb(0, 255, 0);
    Color blue = Color.FromArgb(0, 0, 255);
             
    // Solid brush initialized to red.
    SolidBrush  myBrush = new SolidBrush(red);
    int alpha;

    // x coordinate of first red rectangle
    int x = 50;         
    
    // y coordinate of first red rectangle
    int y = 50;         
                   
    // Fill rectangles with red, varying the alpha value from 25 to 250.
    for (alpha = 25; alpha <= 250; alpha += 25)
    {
        myBrush.Color = Color.FromArgb(alpha, red);
        g.FillRectangle(myBrush, x, y, 50, 100);
        g.FillRectangle(myBrush, x, y + 250, 50, 50);
        x += 50;
    }
    // x coordinate of first green rectangle.
    x = 50;             
    
    // y coordinate of first green rectangle.
    y += 50;            
                      
    // Fill rectangles with green, varying the alpha value from 25 to 250.
    for (alpha = 25; alpha <= 250; alpha += 25)
    {
        myBrush.Color = Color.FromArgb(alpha, green);
        g.FillRectangle(myBrush, x, y, 50, 150);
        x += 50;
    }
    // x coordinate of first blue rectangle.
    x = 50;             
    
    // y coordinate of first blue rectangle.
    y += 100;           
             
    // Fill rectangles with blue, varying the alpha value from 25 to 250.
    for (alpha = 25; alpha <= 250; alpha += 25)
    {
        myBrush.Color = Color.FromArgb(alpha, blue);
        g.FillRectangle(myBrush, x, y, 50, 150);
        x += 50;
    }
}

FromArgb(Int32, Color)

Source:

Color.cs

Crée une structure Color à partir de la structure Color spécifiée, mais avec la nouvelle valeur alpha spécifiée. Bien que cette méthode autorise la transmission d’une valeur 32 bits pour la valeur alpha, la valeur est limitée à 8 bits.

C#

public static System.Drawing.Color FromArgb (int alpha, System.Drawing.Color baseColor);

Paramètres

alpha

Int32

Valeur alpha pour la nouvelle Color. Les valeurs valides sont comprises entre 0 et 255.

baseColor

Color

La Color à partir de laquelle créer la nouvelle Color.

Retours

Color

La Color créée par cette méthode.

Exceptions

ArgumentException

alpha est inférieur à 0 ou supérieur à 255.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

1. Crée Color structures à partir des trois valeurs du composant de couleur (rouge, vert, bleu). Trois structures Color sont créées, une pour chaque couleur primaire.

2. Itère à travers une plage de valeurs alpha, en modifiant la valeur alpha d’une couleur.

3. Pendant chaque itération, définit la couleur d’un pinceau sur la couleur modifiée et peint un rectangle pour afficher la couleur.

4. Répète les étapes 2 et 3 pour chaque couleur primaire.

La valeur alpha n’est jamais entièrement opaque et les rectangles se chevauchent afin d’obtenir des effets de combinaison de couleurs.

C#

public void FromArgb3(PaintEventArgs e)
{
    Graphics     g = e.Graphics;
             
    // Opaque colors (alpha value defaults to 255 -- max value).
    Color red = Color.FromArgb(255, 0, 0);
    Color green = Color.FromArgb(0, 255, 0);
    Color blue = Color.FromArgb(0, 0, 255);
             
    // Solid brush initialized to red.
    SolidBrush  myBrush = new SolidBrush(red);
    int alpha;
    
    // x coordinate of first red rectangle
    int x = 50;         
    
    // y coordinate of first red rectangle
    int y = 50;         
    
    // Fill rectangles with red, varying the alpha value from 25 to 250.
    for (alpha = 25; alpha <= 250; alpha += 25)
    {
        myBrush.Color = Color.FromArgb(alpha, red);
        g.FillRectangle(myBrush, x, y, 50, 100);
        g.FillRectangle(myBrush, x, y + 250, 50, 50);
        x += 50;
    }
    // x coordinate of first green rectangle
    x = 50;             
    
    // y coordinate of first green rectangle
    y += 50;            
    
    // Fill rectangles with green, varying the alpha value from 25 to 250.
    for (alpha = 25; alpha <= 250; alpha += 25)
    {
        myBrush.Color = Color.FromArgb(alpha, green);
        g.FillRectangle(myBrush, x, y, 50, 150);
        x += 50;
    }
    // x coordinate of first blue rectangle.
    x = 50; 
    
     // y coordinate of first blue rectangle
    y += 100;           

    // Fill rectangles with blue, varying the alpha value from 25 to 250.
    for (alpha = 25; alpha <= 250; alpha += 25)
    {
        myBrush.Color = Color.FromArgb(alpha, blue);
        g.FillRectangle(myBrush, x, y, 50, 150);
        x += 50;
    }
}

Remarques

Pour créer une couleur opaque, définissez alpha sur 255. Pour créer une couleur semi-transparente, définissez alpha sur n’importe quelle valeur comprise entre 1 et 254.

FromArgb(Int32)

Source:

Color.cs

Crée une structure Color à partir d’une valeur ARVB 32 bits.

C#

public static System.Drawing.Color FromArgb (int argb);

Paramètres

argb

Int32

Valeur spécifiant la valeur ARVB 32 bits.

Retours

Color

Structure Color créée par cette méthode.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

• Crée trois pinceaux, chacun une couleur différente. Chaque structure Color utilisée pour créer un pinceau est créée à partir d’une valeur ARVB 32 bits.

• Utilise un triangle imaginaire pour positionner trois cercles.

• Peint trois cercles qui se chevauchent, chacun centré sur un sommet du triangle, à l’aide d’un pinceau différent pour chaque cercle.

C#

public void FromArgb4(PaintEventArgs e)
{
    Graphics     g = e.Graphics;
             
    // Transparent red, green, and blue brushes.
    SolidBrush trnsRedBrush = new SolidBrush(Color.FromArgb(0x78FF0000));
    SolidBrush trnsGreenBrush = new SolidBrush(Color.FromArgb(0x7800FF00));
    SolidBrush trnsBlueBrush = new SolidBrush(Color.FromArgb(0x780000FF));
             
    // Base and height of the triangle that is used to position the
    // circles. Each vertex of the triangle is at the center of one of the
    // 3 circles. The base is equal to the diameter of the circles.
    float   triBase = 100;
    float   triHeight = (float)Math.Sqrt(3*(triBase*triBase)/4);
             
    // coordinates of first circle's bounding rectangle.
    float   x1 = 40;
    float   y1 = 40;
             
    // Fill 3 over-lapping circles. Each circle is a different color.
    g.FillEllipse(trnsRedBrush, x1, y1, 2*triHeight, 2*triHeight);
    g.FillEllipse(trnsGreenBrush, x1 + triBase/2, y1 + triHeight,
        2*triHeight, 2*triHeight);
    g.FillEllipse(trnsBlueBrush, x1 + triBase, y1, 2*triHeight, 2*triHeight);
}

Remarques

L’ordre des octets de la valeur ARVB 32 bits est AARRGGBB. L’octet le plus significatif (MSB), représenté par AA, est la valeur du composant alpha. Les deuxième, troisième et quatrième octets, représentés respectivement par RR, GG et BB, sont respectivement les composants de couleur rouge, vert et bleu.