ImageAttributes.SetColorKey Método

Definición

Espacio de nombres:

System.Drawing.Imaging

Ensamblado:

System.Drawing.Common.dll

Paquete:

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

Establece la clave de color (intervalo de transparencia).

Sobrecargas

SetColorKey(Color, Color, ColorAdjustType)	Establece la clave de color (intervalo de transparencia) para una categoría especificada.
SetColorKey(Color, Color)	Establece la clave de color de la categoría predeterminada.

SetColorKey(Color, Color, ColorAdjustType)

Source:

ImageAttributes.cs

Establece la clave de color (intervalo de transparencia) para una categoría especificada.

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)

Parámetros

colorLow

Color

Valor de clave de color bajo.

colorHigh

Color

Valor de clave de color alto.

type

ColorAdjustType

Elemento de ColorAdjustType que especifica la categoría para la que se establece la clave de color.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

1. Abre un Image que usa el archivo Circle.bmp y lo dibuja en la pantalla.

2. Crea un objeto ImageAttributes y establece su clave de color llamando al método SetColorKey.

3. Dibuja la imagen en la pantalla mediante la clave de color del objeto 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

Comentarios

Este método establece los valores de clave de color alto y bajo para que un rango de colores se pueda hacer transparente. Cualquier color que tenga cada uno de sus tres componentes (rojo, verde, azul) entre los componentes correspondientes de las teclas de color alto y bajo se hace transparente.

Un objeto ImageAttributes mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar una clave de color para la categoría predeterminada, una clave de color diferente para la categoría de mapa de bits y una clave de color diferente para la categoría de lápiz.

La configuración predeterminada de ajuste de color y ajuste de escala de grises se aplica a todas las categorías que no tienen valores de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.

En cuanto especifique un ajuste de color o ajuste de escala de grises para una determinada categoría, la configuración de ajuste predeterminada ya no se aplica a esa categoría. Por ejemplo, supongamos que especifica una colección de opciones de ajuste para la categoría predeterminada. Si establece la clave de color para la categoría de lápiz pasando Pen al método SetColorKey, ninguna de las opciones de ajuste predeterminadas se aplicará a los lápices.

SetColorKey(Color, Color)

Source:

ImageAttributes.cs

Establece la clave de color de la categoría predeterminada.

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)

Parámetros

colorLow

Color

Valor de clave de color bajo.

colorHigh

Color

Valor de clave de color alto.

Ejemplos

Para obtener un ejemplo de código, consulte el método SetColorKey(Color, Color, ColorAdjustType).

Comentarios

Este método establece los valores de clave de color alto y bajo para que un rango de colores se pueda hacer transparente. Cualquier color que tenga cada uno de sus tres componentes (rojo, verde, azul) entre los componentes correspondientes de las teclas de color alto y bajo se hace transparente.

Un objeto ImageAttributes mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar una clave de color para la categoría predeterminada, una clave de color diferente para la categoría de mapa de bits y una clave de color diferente para la categoría de lápiz.

La configuración predeterminada de ajuste de color y ajuste de escala de grises se aplica a todas las categorías que no tienen valores de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.