ImageAttributes.SetColorKey Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define a tecla de cor (intervalo de transparência).
Sobrecargas
| Name | Description |
|---|---|
| SetColorKey(Color, Color, ColorAdjustType) |
Define a chave de cor (intervalo de transparência) para uma categoria especificada. |
| SetColorKey(Color, Color) |
Define a chave de cores para a categoria padrão. |
SetColorKey(Color, Color, ColorAdjustType)
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
Define a chave de cor (intervalo de transparência) para uma categoria 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
O baixo valor da chave de cor.
- colorHigh
- Color
O elevado valor da color-key.
- type
- ColorAdjustType
Um elemento de ColorAdjustType isso especifica a categoria para a qual a chave de cor está definida.
Exemplos
O seguinte exemplo de código foi concebido para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do tratador de eventos Paint. O código executa as seguintes ações:
Abre um Image que usa o ficheiro Circle.bmp e desenha-o para o ecrã.
Cria um ImageAttributes objeto e define a sua chave de cores chamando o SetColorKey método.
Desenha a imagem para o ecrã usando a tecla de cores do 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
Observações
Este método define os valores da chave de cor alta e baixa para que uma gama de cores possa ser tornada transparente. Qualquer cor que tenha cada um dos seus três componentes (vermelho, verde, azul) entre os componentes correspondentes das teclas de cor alta e baixa é tornada transparente.
Um ImageAttributes objeto mantém definições de cor e tons de cinzento para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, podes especificar uma chave de cores para a categoria padrão, uma chave de cores diferente para a categoria bitmap e ainda uma chave de cores diferente para a categoria caneta.
As definições padrão de ajuste de cor e de escala de cinzentos aplicam-se a todas as categorias que não tenham definições próprias de ajuste. Por exemplo, se nunca especificares definições de ajuste para a categoria de canetas, as definições padrão aplicam-se à categoria de canetas.
Assim que especificas uma definição de ajuste de cor ou de escala de cinzentos para uma determinada categoria, as definições de ajuste padrão deixam de se aplicar a essa categoria. Por exemplo, suponha que especifica uma coleção de definições de ajuste para a categoria padrão. Se definires a chave de cor para a categoria da caneta passando Pen para o SetColorKey método, nenhuma das definições de ajuste padrão se aplicará às canetas.
Aplica-se a
SetColorKey(Color, Color)
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
- Origem:
- ImageAttributes.cs
Define a chave de cores para a categoria padrão.
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
O baixo valor da chave de cor.
- colorHigh
- Color
O elevado valor da color-key.
Exemplos
Para um exemplo de código, veja o SetColorKey(Color, Color, ColorAdjustType) método.
Observações
Este método define os valores da chave de cor alta e baixa para que uma gama de cores possa ser tornada transparente. Qualquer cor que tenha cada um dos seus três componentes (vermelho, verde, azul) entre os componentes correspondentes das teclas de cor alta e baixa é tornada transparente.
Um ImageAttributes objeto mantém definições de cor e tons de cinzento para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, podes especificar uma chave de cores para a categoria padrão, uma chave de cores diferente para a categoria bitmap e ainda uma chave de cores diferente para a categoria caneta.
As definições padrão de ajuste de cor e de escala de cinzentos aplicam-se a todas as categorias que não tenham definições próprias de ajuste. Por exemplo, se nunca especificares definições de ajuste para a categoria de canetas, as definições padrão aplicam-se à categoria de canetas.