Freigeben über


ImageAttributes.SetColorKey Methode

Definition

Legt den Farbschlüssel (Transparenzbereich) fest.

Überlädt

SetColorKey(Color, Color, ColorAdjustType)

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

SetColorKey(Color, Color)

Legt den Farbschlüssel für die Standardkategorie fest.

SetColorKey(Color, Color, ColorAdjustType)

Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs

Legt den Farbschlüssel (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 Wert für einen niedrigen Farbschlüssel.

colorHigh
Color

Der Wert für hohen Farbschlüssel.

type
ColorAdjustType

Ein Element von ColorAdjustType, das die Kategorie angibt, für die der Farbschlüssel festgelegt wird.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. 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 fest, indem die SetColorKey -Methode aufgerufen wird.

  3. Zeichnet das Bild mithilfe der Farbtaste des ImageAttributes-Objekts auf den 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 hohe und niedrige Farbschlüssel festgelegt, sodass ein Farbbereich transparent gemacht werden kann. Jede Farbe, die jede seiner drei Komponenten (Rot, Grün, Blau) zwischen den entsprechenden Komponenten der hohen und niedrigen Farbtasten enthält, wird transparent gemacht.

Ein ImageAttributes-Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können z. B. 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 aufweisen. Wenn Sie beispielsweise niemals 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 Pen an die SetColorKey Methode übergeben, gelten keine der Standardeinstellungen für Anpassungen für Stifte.

Gilt für:

SetColorKey(Color, Color)

Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs
Quelle:
ImageAttributes.cs

Legt den Farbschlüssel 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 Wert für einen niedrigen Farbschlüssel.

colorHigh
Color

Der Wert für hohen Farbschlüssel.

Beispiele

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

Hinweise

Mit dieser Methode werden die Werte für hohe und niedrige Farbschlüssel festgelegt, sodass ein Farbbereich transparent gemacht werden kann. Jede Farbe, die jede seiner drei Komponenten (Rot, Grün, Blau) zwischen den entsprechenden Komponenten der hohen und niedrigen Farbtasten enthält, wird transparent gemacht.

Ein ImageAttributes-Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können z. B. 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 aufweisen. Wenn Sie beispielsweise niemals Anpassungseinstellungen für die Stiftkategorie angeben, gelten die Standardeinstellungen für die Stiftkategorie.

Gilt für: