ImageAttributes.SetColorKey Метод

Определение

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

System.Drawing.Imaging

Сборка:

System.Drawing.Common.dll

Пакет:

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

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

Перегрузки

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

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

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

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