ImageAttributes.SetColorKey 方法

定義

設定色彩鍵 (透明度範圍)。Sets the color key (transparency range).

多載

SetColorKey(Color, Color)

設定預設分類的色鍵。Sets the color key for the default category.

SetColorKey(Color, Color, ColorAdjustType)

設定指定分類的色鍵 (透明度範圍)。Sets the color key (transparency range) for a specified category.

SetColorKey(Color, Color)

設定預設分類的色鍵。Sets the color key for the default category.

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

低色鍵值。The low color-key value.

colorHigh
Color

高色鍵值。The high color-key value.

範例

如需程式碼範例, 請SetColorKey(Color, Color, ColorAdjustType)參閱方法。For a code example, see the SetColorKey(Color, Color, ColorAdjustType) method.

備註

這個方法會設定高和低的色彩索引鍵值, 以便將色彩範圍設為透明。This method sets the high and low color-key values so that a range of colors can be made transparent. 具有三個元件 (紅色、綠色、藍色) 的任何色彩, 在高和低色彩索引鍵的對應元件之間會變成透明。Any color that has each of its three components (red, green, blue) between the corresponding components of the high and low color keys is made transparent.

ImageAttributes物件會維護五個調整類別的色彩和灰階設定: 預設、點陣圖、筆刷、畫筆和文字。An ImageAttributes object maintains color and grayscale settings for five adjustment categories: default, bitmap, brush, pen, and text. 例如, 您可以指定預設分類的色彩索引鍵、點陣圖類別目錄的不同色彩索引鍵, 以及畫筆類別目錄的不同色彩索引鍵。For example, you can specify a color key for the default category, a different color key for the bitmap category, and still a different color key for the pen category.

預設的彩色調整和灰階調整設定適用于沒有自己的調整設定的所有類別。The default color-adjustment and grayscale-adjustment settings apply to all categories that do not have adjustment settings of their own. 例如, 如果您從未針對 [畫筆] 分類指定任何調整設定, 則預設設定會套用至 [畫筆] 分類。For example, if you never specify any adjustment settings for the pen category, the default settings apply to the pen category.

SetColorKey(Color, Color, ColorAdjustType)

設定指定分類的色鍵 (透明度範圍)。Sets the color key (transparency range) for a specified category.

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

低色鍵值。The low color-key value.

colorHigh
Color

高色鍵值。The high color-key value.

type
ColorAdjustType

ColorAdjustType 的元素,指定已經設定色鍵的分類。An element of ColorAdjustType that specifies the category for which the color key is set.

範例

下列程式碼範例是針對與 Windows Forms 搭配使用所設計, 而且PaintEventArgs它需要e, 這Paint是事件處理常式的參數。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. 該程式碼執行下列動作:The code performs the following actions:

  1. 開啟使用檔案 Circle 的,並將它繪製到螢幕上。ImageOpens an Image that uses the file Circle.bmp and draws it to the screen.

  2. 建立物件, 並藉由SetColorKey呼叫方法來設定其色彩索引鍵。 ImageAttributesCreates an ImageAttributes object and sets its color key by calling the SetColorKey method.

  3. 使用ImageAttributes物件的色彩索引鍵, 將影像繪製到螢幕上。Draws the image to the screen using the color key of the ImageAttributes object.

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

備註

這個方法會設定高和低的色彩索引鍵值, 以便將色彩範圍設為透明。This method sets the high and low color-key values so that a range of colors can be made transparent. 具有三個元件 (紅色、綠色、藍色) 的任何色彩, 在高和低色彩索引鍵的對應元件之間會變成透明。Any color that has each of its three components (red, green, blue) between the corresponding components of the high and low color keys is made transparent.

ImageAttributes物件會維護五個調整類別的色彩和灰階設定: 預設、點陣圖、筆刷、畫筆和文字。An ImageAttributes object maintains color and grayscale settings for five adjustment categories: default, bitmap, brush, pen, and text. 例如, 您可以指定預設分類的色彩索引鍵、點陣圖類別目錄的不同色彩索引鍵, 以及畫筆類別目錄的不同色彩索引鍵。For example, you can specify a color key for the default category, a different color key for the bitmap category, and still a different color key for the pen category.

預設的彩色調整和灰階調整設定適用于沒有自己的調整設定的所有類別。The default color-adjustment and grayscale-adjustment settings apply to all categories that do not have adjustment settings of their own. 例如, 如果您從未針對 [畫筆] 分類指定任何調整設定, 則預設設定會套用至 [畫筆] 分類。For example, if you never specify any adjustment settings for the pen category, the default settings apply to the pen category.

當您指定特定分類的彩色調整或灰階調整設定時, 預設調整設定就不再適用于該類別。As soon as you specify a color-adjustment or grayscale-adjustment setting for a certain category, the default adjustment settings no longer apply to that category. 例如, 假設您為預設分類指定調整設定的集合。For example, suppose you specify a collection of adjustment settings for the default category. 如果您藉由傳遞Pen SetColorKey至方法來設定畫筆類別目錄的色彩索引鍵, 則不會將任何預設的調整設定套用到畫筆。If you set the color key for the pen category by passing Pen to the SetColorKey method, none of the default adjustment settings will apply to pens.

適用於