ImageAttributes.SetColorKey Метод

Определение

Пространство имен:

System.Drawing.Imaging

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Задает цветовой ключ (диапазон прозрачности).

Перегрузки

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. Открывает объект , Image использующий файл Circle.bmp и рисующий его на экране.

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 поддерживает параметры цвета и оттенков серого для пяти категорий корректировки: по умолчанию, точечный рисунок, кисть, перо и текст. Например, можно указать цвет для категории по умолчанию, другой цвет для категории точечных рисунков и другой цвет для категории пера.

Параметры настройки цвета и оттенков серого по умолчанию применяются ко всем категориям, которые не имеют собственных параметров настройки. Например, если вы никогда не указываете параметры корректировки для категории пера, параметры по умолчанию применяются к категории пера.

Как только вы укажете параметр настройки цвета или оттенка серого для определенной категории, параметры настройки по умолчанию больше не применяются к этой категории. Например, предположим, что вы указали коллекцию параметров корректировки для категории по умолчанию. Если задать цвет для категории пера путем передачи PenSetColorKey в метод , ни один из параметров настройки по умолчанию не будет применяться к ручкам.

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 поддерживает параметры цвета и оттенков серого для пяти категорий корректировки: по умолчанию, точечный рисунок, кисть, перо и текст. Например, можно указать цвет для категории по умолчанию, другой цвет для категории точечных рисунков и другой цвет для категории пера.

Параметры настройки цвета и оттенков серого по умолчанию применяются ко всем категориям, которые не имеют собственных параметров настройки. Например, если вы никогда не указываете параметры корректировки для категории пера, параметры по умолчанию применяются к категории пера.