ImageAttributes.SetColorKey Metoda

Definicja

Przestrzeń nazw:

System.Drawing.Imaging

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

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 tego określa kategorię, dla której ustawiono klucz koloru.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z Windows Forms i wymaga PaintEventArgseparametru Paint programu obsługi zdarzeń. Kod wykonuje następujące akcje:

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

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

3. Rysuje obraz na ekran przy użyciu klucza ImageAttributes koloru obiektu.

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 zakres kolorów mógł być przezroczysty. Każdy kolor, który ma każdy z trzech składników (czerwony, zielony, niebieski) między odpowiednimi składnikami kluczy o wysokim i niskim kolorze, jest przezroczysty.

Obiekt ImageAttributes zachowuje ustawienia koloru i skali szarości dla pięciu kategorii korekt: domyślne, mapy bitowe, pędzle, pióro i tekst. Na przykład można 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 dostosowania kolorów i skali szarości mają zastosowanie do wszystkich kategorii, które nie mają własnych ustawień regulacji. Jeśli na przykład nigdy nie określisz żadnych ustawień korekty dla kategorii pióra, ustawienia domyślne będą miały zastosowanie do kategorii pióra.

Gdy tylko określisz ustawienie korekty koloru lub 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 SetColorKey metody , ż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 zakres kolorów mógł być przezroczysty. Każdy kolor, który ma każdy z trzech składników (czerwony, zielony, niebieski) między odpowiednimi składnikami kluczy o wysokim i niskim kolorze, jest przezroczysty.

Obiekt ImageAttributes zachowuje ustawienia koloru i skali szarości dla pięciu kategorii korekt: domyślne, mapy bitowe, pędzle, pióro i tekst. Na przykład można 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 dostosowania kolorów i skali szarości mają zastosowanie do wszystkich kategorii, które nie mają własnych ustawień regulacji. Jeśli na przykład nigdy nie określisz żadnych ustawień korekty dla kategorii pióra, ustawienia domyślne będą miały zastosowanie do kategorii pióra.