ImageAttributes.SetColorKey Metoda

Definicja

Przestrzeń nazw:

System.Drawing.Imaging

Zestaw:

System.Drawing.Common.dll

Pakiet:

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

Ustawia klucz koloru (zakres przezroczystości).

Przeciążenia

SetColorKey(Color, Color, ColorAdjustType)	Ustawia klucz koloru (zakres przezroczystości) dla określonej kategorii.
SetColorKey(Color, Color)	Ustawia klucz koloru dla kategorii domyślnej.

SetColorKey(Color, Color, ColorAdjustType)

Źródło:

ImageAttributes.cs

Ustawia klucz koloru (zakres przezroczystości) dla określonej kategorii.

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)

Parametry

colorLow

Color

Niska wartość klucza koloru.

colorHigh

Color

Wysoka wartość klucza koloru.

type

ColorAdjustType

Element ColorAdjustType określający kategorię, dla której ustawiono klucz koloru.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z formularzami Systemu Windows i wymaga PaintEventArgse, który jest parametrem programu obsługi zdarzeń Paint. Kod wykonuje następujące akcje:

1. Otwiera Image, który używa Circle.bmp pliku i rysuje go na ekranie.

2. Tworzy obiekt ImageAttributes i ustawia jego klucz koloru, wywołując metodę SetColorKey.

3. Rysuje obraz na ekranie przy użyciu klucza koloru obiektu 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

Uwagi

Ta metoda ustawia wysokie i niskie wartości klucza kolorów, aby można było uzyskać przezroczysty zakres kolorów. Każdy kolor, który ma każdy z trzech składników (czerwony, zielony, niebieski) między odpowiednimi składnikami wysokich i niskich kolorów jest przezroczysty.

Obiekt ImageAttributes zachowuje ustawienia koloru i skali szarości dla pięciu kategorii korekty: domyślne, mapy bitowej, pędzla, pióra i tekstu. Można na przykład określić klucz koloru dla kategorii domyślnej, inny klucz koloru dla kategorii mapy bitowej i nadal inny klucz koloru dla kategorii pióra.

Domyślne ustawienia korekty kolorów i korekty skali szarości mają zastosowanie do wszystkich kategorii, które nie mają własnych ustawień korekty. Jeśli na przykład nigdy nie określisz żadnych ustawień korekty dla kategorii pióra, ustawienia domyślne będą stosowane do kategorii pióra.

Gdy tylko określisz ustawienie korekty kolorów lub korekty skali szarości dla określonej kategorii, domyślne ustawienia korekty nie będą już stosowane do tej kategorii. Załóżmy na przykład, że określisz kolekcję ustawień korekty dla kategorii domyślnej. Jeśli ustawisz klucz koloru dla kategorii pióra, przekazując Pen do metody SetColorKey, żadne z domyślnych ustawień korekty nie będzie miało zastosowania do piór.

SetColorKey(Color, Color)

Źródło:

ImageAttributes.cs

Ustawia klucz koloru dla kategorii domyślnej.

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)

Parametry

colorLow

Color

Niska wartość klucza koloru.

colorHigh

Color

Wysoka wartość klucza koloru.

Przykłady

Aby zapoznać się z przykładem kodu, zobacz metodę SetColorKey(Color, Color, ColorAdjustType).

Uwagi

Ta metoda ustawia wysokie i niskie wartości klucza kolorów, aby można było uzyskać przezroczysty zakres kolorów. Każdy kolor, który ma każdy z trzech składników (czerwony, zielony, niebieski) między odpowiednimi składnikami wysokich i niskich kolorów jest przezroczysty.

Obiekt ImageAttributes zachowuje ustawienia koloru i skali szarości dla pięciu kategorii korekty: domyślne, mapy bitowej, pędzla, pióra i tekstu. Można na przykład określić klucz koloru dla kategorii domyślnej, inny klucz koloru dla kategorii mapy bitowej i nadal inny klucz koloru dla kategorii pióra.

Domyślne ustawienia korekty kolorów i korekty skali szarości mają zastosowanie do wszystkich kategorii, które nie mają własnych ustawień korekty. Jeśli na przykład nigdy nie określisz żadnych ustawień korekty dla kategorii pióra, ustawienia domyślne będą stosowane do kategorii pióra.