ImageAttributes.SetColorKey Méthode

Définition

Espace de noms:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v9.0.0-rc.1.24451.1

Définit la clé de couleur (plage de transparence).

Surcharges

SetColorKey(Color, Color, ColorAdjustType)	Définit la clé de couleur (plage de transparence) pour une catégorie spécifiée.
SetColorKey(Color, Color)	Définit la clé de couleur pour la catégorie par défaut.

SetColorKey(Color, Color, ColorAdjustType)

Source:

ImageAttributes.cs

Définit la clé de couleur (plage de transparence) pour une catégorie spécifiée.

public:
 void SetColorKey(System::Drawing::Color colorLow, System::Drawing::Color colorHigh, System::Drawing::Imaging::ColorAdjustType type);

public void SetColorKey (System.Drawing.Color colorLow, System.Drawing.Color colorHigh, System.Drawing.Imaging.ColorAdjustType type);

member this.SetColorKey : System.Drawing.Color * System.Drawing.Color * System.Drawing.Imaging.ColorAdjustType -> unit

Public Sub SetColorKey (colorLow As Color, colorHigh As Color, type As ColorAdjustType)

Paramètres

colorLow

Color

Valeur de clé de couleur faible.

colorHigh

Color

Valeur de clé de couleur élevée.

type

ColorAdjustType

Élément de ColorAdjustType qui spécifie la catégorie pour laquelle la clé de couleur est définie.

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. Ouvre un Image qui utilise le fichier Circle.bmp et le dessine à l’écran.

2. Crée un objet ImageAttributes et définit sa clé de couleur en appelant la méthode SetColorKey.

3. Dessine l’image à l’écran à l’aide de la touche de couleur de l’objet ImageAttributes.

private:
   void SetColorKeyExample( PaintEventArgs^ e )
   {
      // Open an Image file and draw it to the screen.
      Image^ myImage = Image::FromFile( "Circle.bmp" );
      e->Graphics->DrawImage( myImage, 20, 20 );

      // Create an ImageAttributes object and set the color key.
      Color lowerColor = Color::FromArgb( 245, 0, 0 );
      Color upperColor = Color::FromArgb( 255, 0, 0 );
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetColorKey( lowerColor, upperColor, ColorAdjustType::Default );

      // Draw the image with the color key set.
      Rectangle rect = Rectangle(150,20,100,100);
      e->Graphics->DrawImage( myImage, rect, 0, 0, 100, 100, GraphicsUnit::Pixel, imageAttr );
   }

private void SetColorKeyExample(PaintEventArgs e)
{
             
    // Open an Image file and draw it to the screen.
    Image myImage = Image.FromFile("Circle.bmp");
    e.Graphics.DrawImage(myImage, 20, 20);
             
    // Create an ImageAttributes object and set the color key.
    Color lowerColor = Color.FromArgb(245,0,0);
    Color upperColor = Color.FromArgb(255,0,0);
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetColorKey(lowerColor,
        upperColor,
        ColorAdjustType.Default);
             
    // Draw the image with the color key set.
    Rectangle rect = new Rectangle(150, 20, 100, 100);
    e.Graphics.DrawImage(myImage, rect, 0, 0, 100, 100, 
        GraphicsUnit.Pixel, imageAttr);      
}

Public Sub SetColorKeyExample(ByVal e As PaintEventArgs)

    ' Open an Image file, and draw it to the screen.
    Dim myImage As Image = Image.FromFile("Circle.bmp")
    e.Graphics.DrawImage(myImage, 20, 20)

    ' Create an ImageAttributes object and set the color key.
    Dim lowerColor As Color = Color.FromArgb(245, 0, 0)
    Dim upperColor As Color = Color.FromArgb(255, 0, 0)
    Dim imageAttr As New ImageAttributes
    imageAttr.SetColorKey(lowerColor, upperColor, _
    ColorAdjustType.Default)

    ' Draw the image with the color key set.
    Dim rect As New Rectangle(150, 20, 100, 100)
    e.Graphics.DrawImage(myImage, rect, 0, 0, 100, 100, _
    GraphicsUnit.Pixel, imageAttr)
    ' Image
End Sub

Remarques

Cette méthode définit les valeurs de clé haute et basse couleur afin qu’une plage de couleurs puisse être rendue transparente. Toute couleur qui a chacun de ses trois composants (rouge, vert, bleu) entre les composants correspondants des touches de couleur haute et basse est rendue transparente.

Un objet ImageAttributes conserve les paramètres de couleur et de nuances de gris pour cinq catégories d’ajustement : par défaut, bitmap, pinceau, stylet et texte. Par exemple, vous pouvez spécifier une clé de couleur pour la catégorie par défaut, une clé de couleur différente pour la catégorie bitmap, et toujours une clé de couleur différente pour la catégorie de stylet.

Les paramètres d’ajustement de couleur et d’ajustement des nuances de gris par défaut s’appliquent à toutes les catégories qui n’ont pas de paramètres d’ajustement propres. Par exemple, si vous ne spécifiez jamais de paramètres d’ajustement pour la catégorie de stylet, les paramètres par défaut s’appliquent à la catégorie de stylet.

Dès que vous spécifiez un paramètre d’ajustement de couleur ou d’ajustement des nuances de gris pour une certaine catégorie, les paramètres d’ajustement par défaut ne s’appliquent plus à cette catégorie. Par exemple, supposons que vous spécifiez une collection de paramètres d’ajustement pour la catégorie par défaut. Si vous définissez la touche de couleur pour la catégorie de stylet en passant Pen à la méthode SetColorKey, aucun des paramètres d’ajustement par défaut ne s’applique aux stylets.

SetColorKey(Color, Color)

Source:

ImageAttributes.cs

Définit la clé de couleur pour la catégorie par défaut.

public:
 void SetColorKey(System::Drawing::Color colorLow, System::Drawing::Color colorHigh);

public void SetColorKey (System.Drawing.Color colorLow, System.Drawing.Color colorHigh);

member this.SetColorKey : System.Drawing.Color * System.Drawing.Color -> unit

Public Sub SetColorKey (colorLow As Color, colorHigh As Color)

Paramètres

colorLow

Color

Valeur de clé de couleur faible.

colorHigh

Color

Valeur de clé de couleur élevée.

Exemples

Pour obtenir un exemple de code, consultez la méthode SetColorKey(Color, Color, ColorAdjustType).

Remarques

Cette méthode définit les valeurs de clé haute et basse couleur afin qu’une plage de couleurs puisse être rendue transparente. Toute couleur qui a chacun de ses trois composants (rouge, vert, bleu) entre les composants correspondants des touches de couleur haute et basse est rendue transparente.

Un objet ImageAttributes conserve les paramètres de couleur et de nuances de gris pour cinq catégories d’ajustement : par défaut, bitmap, pinceau, stylet et texte. Par exemple, vous pouvez spécifier une clé de couleur pour la catégorie par défaut, une clé de couleur différente pour la catégorie bitmap, et toujours une clé de couleur différente pour la catégorie de stylet.

Les paramètres d’ajustement de couleur et d’ajustement des nuances de gris par défaut s’appliquent à toutes les catégories qui n’ont pas de paramètres d’ajustement propres. Par exemple, si vous ne spécifiez jamais de paramètres d’ajustement pour la catégorie de stylet, les paramètres par défaut s’appliquent à la catégorie de stylet.