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);

Параметры

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 = 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);      
}

Комментарии

Этот метод задает высокие и низкие значения ключа цвета, чтобы можно было сделать прозрачным диапазон цветов. Любой цвет, имеющий каждый из трех компонентов (красный, зеленый, синий) между соответствующими компонентами высоких и низких цветов, становится прозрачным.

Объект ImageAttributes поддерживает параметры цвета и серого шкалы для пяти категорий корректировки: по умолчанию, растровая карта, кисть, перо и текст. Например, можно указать цветной ключ для категории по умолчанию, другой цветной ключ для категории растрового изображения и по-прежнему другой цветной ключ для категории пера.

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

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

SetColorKey(Color, Color)

Исходный код:

ImageAttributes.cs

Задает цветной ключ для категории по умолчанию.

public void SetColorKey (System.Drawing.Color colorLow, System.Drawing.Color colorHigh);

Параметры

colorLow

Color

Значение низкой цветовой клавиши.

colorHigh

Color

Значение с высоким цветом ключа.

Примеры

Пример кода см. в методе SetColorKey(Color, Color, ColorAdjustType).

Комментарии

Этот метод задает высокие и низкие значения ключа цвета, чтобы можно было сделать прозрачным диапазон цветов. Любой цвет, имеющий каждый из трех компонентов (красный, зеленый, синий) между соответствующими компонентами высоких и низких цветов, становится прозрачным.

Объект ImageAttributes поддерживает параметры цвета и серого шкалы для пяти категорий корректировки: по умолчанию, растровая карта, кисть, перо и текст. Например, можно указать цветной ключ для категории по умолчанию, другой цветной ключ для категории растрового изображения и по-прежнему другой цветной ключ для категории пера.

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