ImageAttributes.SetColorKey Yöntem

Tanım

Ad Alanı:

System.Drawing.Imaging

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.6.24327.6

Renk anahtarını (saydamlık aralığı) ayarlar.

Aşırı Yüklemeler

SetColorKey(Color, Color, ColorAdjustType)	Belirtilen kategori için renk anahtarını (saydamlık aralığı) ayarlar.
SetColorKey(Color, Color)	Varsayılan kategori için renk anahtarını ayarlar.

SetColorKey(Color, Color, ColorAdjustType)

Kaynak:

ImageAttributes.cs

Belirtilen kategori için renk anahtarını (saydamlık aralığı) ayarlar.

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)

Parametreler

colorLow

Color

Düşük renk anahtarı değeri.

colorHigh

Color

Yüksek renk anahtarı değeri.

type

ColorAdjustType

Renk anahtarının ayarlandığı kategoriyi belirten ColorAdjustType öğesi.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

1. Circle.bmp dosyasını kullanan ve ekrana çizen bir Image açar.

2. bir ImageAttributes nesnesi oluşturur ve SetColorKey yöntemini çağırarak renk anahtarını ayarlar.

3. ImageAttributes nesnesinin renk tuşunu kullanarak görüntüyü ekrana çizer.

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

Açıklamalar

Bu yöntem, bir renk aralığının saydam hale getirilebilmesi için yüksek ve düşük renk anahtarı değerlerini ayarlar. Yüksek ve düşük renk tuşlarının karşılık gelen bileşenleri arasında üç bileşenin (kırmızı, yeşil, mavi) her birine sahip olan tüm renkler saydam hale getirilmiştir.

ImageAttributes nesnesi, beş ayar kategorisi için renk ve gri tonlama ayarlarını korur: varsayılan, bit eşlem, fırça, kalem ve metin. Örneğin, varsayılan kategori için bir renk anahtarı, bit eşlem kategorisi için farklı bir renk anahtarı ve kalem kategorisi için yine de farklı bir renk anahtarı belirtebilirsiniz.

Varsayılan renk ayarlama ve gri tonlamalı ayarlama ayarları, kendi ayarlama ayarları olmayan tüm kategoriler için geçerlidir. Örneğin, kalem kategorisi için hiçbir ayarlama ayarı belirtmezseniz, varsayılan ayarlar kalem kategorisine uygulanır.

Belirli bir kategori için renk ayarlaması veya gri tonlamalı ayarlama ayarı belirttiğiniz anda, varsayılan ayarlama ayarları artık bu kategoriye uygulanmaz. Örneğin, varsayılan kategori için bir ayarlama ayarları koleksiyonu belirttiğinizi varsayalım. Pen SetColorKey yöntemine geçirerek kalem kategorisinin renk anahtarını ayarlarsanız, varsayılan ayarlama ayarlarının hiçbiri kalemlere uygulanmaz.

SetColorKey(Color, Color)

Kaynak:

ImageAttributes.cs

Varsayılan kategori için renk anahtarını ayarlar.

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)

Parametreler

colorLow

Color

Düşük renk anahtarı değeri.

colorHigh

Color

Yüksek renk anahtarı değeri.

Örnekler

Kod örneği için SetColorKey(Color, Color, ColorAdjustType) yöntemine bakın.

Açıklamalar

Bu yöntem, bir renk aralığının saydam hale getirilebilmesi için yüksek ve düşük renk anahtarı değerlerini ayarlar. Yüksek ve düşük renk tuşlarının karşılık gelen bileşenleri arasında üç bileşenin (kırmızı, yeşil, mavi) her birine sahip olan tüm renkler saydam hale getirilmiştir.

ImageAttributes nesnesi, beş ayar kategorisi için renk ve gri tonlama ayarlarını korur: varsayılan, bit eşlem, fırça, kalem ve metin. Örneğin, varsayılan kategori için bir renk anahtarı, bit eşlem kategorisi için farklı bir renk anahtarı ve kalem kategorisi için yine de farklı bir renk anahtarı belirtebilirsiniz.

Varsayılan renk ayarlama ve gri tonlamalı ayarlama ayarları, kendi ayarlama ayarları olmayan tüm kategoriler için geçerlidir. Örneğin, kalem kategorisi için hiçbir ayarlama ayarı belirtmezseniz, varsayılan ayarlar kalem kategorisine uygulanır.