ImageAttributes.SetColorKey Método

Definición

Espacio de nombres:

System.Drawing.Imaging

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Establece la clave de color (intervalo de transparencia).

Sobrecargas

SetColorKey(Color, Color, ColorAdjustType)	Establece la clave de color (intervalo de transparencia) de la categoría predeterminada.
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) de la categoría predeterminada.

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 cuya clave de color se establece.

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 Paint controlador de eventos. El código realiza las siguientes acciones:

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

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

3. Dibuja la imagen en la pantalla con la clave de color del ImageAttributes objeto .

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 ImageAttributes objeto 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 ajustes 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 SetColorKey método , 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 SetColorKey(Color, Color, ColorAdjustType) método .

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 ImageAttributes objeto 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 ajustes 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.