ImageAttributes.SetColorKey Methode

Definition

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Legt den Colorkey (Transparenzbereich) fest.

Überlädt

SetColorKey(Color, Color, ColorAdjustType)	Legt den Colorkey (Transparenzbereich) für eine angegebene Kategorie fest.
SetColorKey(Color, Color)	Legt den Colorkey für die Standardkategorie fest.

SetColorKey(Color, Color, ColorAdjustType)

Quelle:

ImageAttributes.cs

Legt den Colorkey (Transparenzbereich) für eine angegebene Kategorie fest.

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)

Parameter

colorLow

Color

Der niedrige Colorkeywert.

colorHigh

Color

Der hohe Colorkeywert.

type

ColorAdjustType

Ein Element von ColorAdjustType, das die Kategorie angibt, für die der Colorkey festgelegt ist.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code führt die folgenden Aktionen aus:

1. Öffnet eine Image , die die Datei Circle.bmp verwendet, und zeichnet sie auf den Bildschirm.

2. Erstellt ein ImageAttributes -Objekt und legt seinen Farbschlüssel durch Aufrufen der SetColorKey -Methode fest.

3. Zeichnet das Bild mithilfe des Farbschlüssels des Objekts auf den ImageAttributes Bildschirm.

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

Hinweise

Mit dieser Methode werden die werte für den hohen und den niedrigen Farbschlüssel festgelegt, sodass ein Farbbereich transparent gemacht werden kann. Jede Farbe, die über jede ihrer drei Komponenten (Rot, Grün, Blau) zwischen den entsprechenden Komponenten der Hohen und Niedrigen Farbtasten verfügt, wird transparent gemacht.

Ein ImageAttributes Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können beispielsweise einen Farbschlüssel für die Standardkategorie, einen anderen Farbschlüssel für die Bitmapkategorie und dennoch einen anderen Farbschlüssel für die Stiftkategorie angeben.

Die Standardeinstellungen für Farbanpassung und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen haben. Wenn Sie beispielsweise nie Anpassungseinstellungen für die Stiftkategorie angeben, gelten die Standardeinstellungen für die Stiftkategorie.

Sobald Sie eine Farbanpassungs- oder Graustufenanpassungseinstellung für eine bestimmte Kategorie angeben, gelten die Standardeinstellungseinstellungen nicht mehr für diese Kategorie. Angenommen, Sie geben eine Sammlung von Anpassungseinstellungen für die Standardkategorie an. Wenn Sie den Farbschlüssel für die Stiftkategorie festlegen, indem Sie an die SetColorKey -Methode übergebenPen, gilt keine der Standardanpassungseinstellungen für Stifte.

SetColorKey(Color, Color)

Quelle:

ImageAttributes.cs

Legt den Colorkey für die Standardkategorie fest.

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)

Parameter

colorLow

Color

Der niedrige Colorkeywert.

colorHigh

Color

Der hohe Colorkeywert.

Beispiele

Ein Codebeispiel finden Sie in der SetColorKey(Color, Color, ColorAdjustType) -Methode.

Hinweise

Mit dieser Methode werden die werte für den hohen und den niedrigen Farbschlüssel festgelegt, sodass ein Farbbereich transparent gemacht werden kann. Jede Farbe, die über jede ihrer drei Komponenten (Rot, Grün, Blau) zwischen den entsprechenden Komponenten der Hohen und Niedrigen Farbtasten verfügt, wird transparent gemacht.

Ein ImageAttributes Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können beispielsweise einen Farbschlüssel für die Standardkategorie, einen anderen Farbschlüssel für die Bitmapkategorie und dennoch einen anderen Farbschlüssel für die Stiftkategorie angeben.

Die Standardeinstellungen für Farbanpassung und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen haben. Wenn Sie beispielsweise nie Anpassungseinstellungen für die Stiftkategorie angeben, gelten die Standardeinstellungen für die Stiftkategorie.