ImageAttributes.SetColorKey 方法

定義

命名空間:

System.Drawing.Imaging

組件:

System.Drawing.Common.dll

套件:

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

設定色彩索引鍵（透明度範圍）。

多載

SetColorKey(Color, Color, ColorAdjustType)	設定指定類別的色彩索引鍵（透明度範圍）。
SetColorKey(Color, Color)	設定預設類別的色彩索引鍵。

SetColorKey(Color, Color, ColorAdjustType)

來源:

ImageAttributes.cs

設定指定類別的色彩索引鍵（透明度範圍）。

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)

參數

colorLow

Color

低色彩索引鍵值。

colorHigh

Color

高色彩索引鍵值。

type

ColorAdjustType

ColorAdjustType 的 元素，指定設定色彩索引鍵的類別。

範例

下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。 程式代碼會執行下列動作：

1. 開啟使用檔案 Circle.bmp 並將其繪製到畫面的 Image。

2. 建立 ImageAttributes 物件，並藉由呼叫 SetColorKey 方法來設定其色彩索引鍵。

3. 使用 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

備註

這個方法會設定高低色彩索引鍵值，以便讓一系列色彩成為透明。 在高低色彩索引鍵的對應元件之間，具有其三個元件（紅色、綠色、藍色）之間的任何色彩都會成為透明。

ImageAttributes 物件會維護五個調整類別的色彩和灰階設定：預設、位圖、筆刷、手寫筆和文字。 例如，您可以指定預設類別的色彩索引鍵、點陣圖類別的不同色彩索引鍵，以及畫筆類別的色彩索引鍵。

默認色彩調整和灰階調整設定適用於沒有自己調整設定的所有類別。 例如，如果您從未指定畫筆類別的任何調整設定，則預設設定會套用至畫筆類別。

一旦您指定特定類別的色彩調整或灰階調整設定，預設調整設定就不再套用至該類別。 例如，假設您指定預設類別的調整設定集合。 如果您藉由將 Pen 傳遞至 SetColorKey 方法來設定畫筆類別的色彩索引鍵，則預設調整設定都不會套用至畫筆。

SetColorKey(Color, Color)

來源:

ImageAttributes.cs

設定預設類別的色彩索引鍵。

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)

參數

colorLow

Color

低色彩索引鍵值。

colorHigh

Color

高色彩索引鍵值。

範例

如需程式代碼範例，請參閱 SetColorKey(Color, Color, ColorAdjustType) 方法。

備註

這個方法會設定高低色彩索引鍵值，以便讓一系列色彩成為透明。 在高低色彩索引鍵的對應元件之間，具有其三個元件（紅色、綠色、藍色）之間的任何色彩都會成為透明。

ImageAttributes 物件會維護五個調整類別的色彩和灰階設定：預設、位圖、筆刷、手寫筆和文字。 例如，您可以指定預設類別的色彩索引鍵、點陣圖類別的不同色彩索引鍵，以及畫筆類別的色彩索引鍵。

默認色彩調整和灰階調整設定適用於沒有自己調整設定的所有類別。 例如，如果您從未指定畫筆類別的任何調整設定，則預設設定會套用至畫筆類別。