ImageAttributes.SetColorKey Metodo

Definizione

Imposta la chiave di colore (intervallo di trasparenza).

Overload

SetColorKey(Color, Color)

Imposta la chiave di colore per la categoria predefinita.

SetColorKey(Color, Color, ColorAdjustType)

Imposta la chiave di colore (intervallo di trasparenza) per una categoria specificata.

SetColorKey(Color, Color)

Imposta la chiave di colore per la categoria predefinita.

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)

Parametri

colorLow
Color

Valore minimo della chiave di colore.

colorHigh
Color

Valore massimo della chiave di colore.

Esempio

Per un esempio di codice, vedere il SetColorKey(Color, Color, ColorAdjustType) metodo.

Commenti

Questo metodo imposta i valori della chiave di colore alta e bassa in modo che sia possibile rendere trasparente un intervallo di colori. Qualsiasi colore con ognuno dei tre componenti (rosso, verde, blu) tra i componenti corrispondenti delle chiavi di colore alta e bassa viene reso trasparente.

Un ImageAttributes oggetto mantiene le impostazioni relative ai colori e alle gradazioni di grigio per cinque categorie di regolazione: predefinita, bitmap, pennello, penna e testo. È ad esempio possibile specificare una chiave di colore per la categoria predefinita, una chiave di colore diversa per la categoria bitmap e ancora una chiave di colore diversa per la categoria Pen.

Le impostazioni predefinite per la regolazione del colore e la regolazione delle gradazioni di grigio si applicano a tutte le categorie per le quali non sono disponibili impostazioni di regolazione. Se, ad esempio, non si specificano mai impostazioni di regolazione per la categoria Pen, le impostazioni predefinite verranno applicate alla categoria Pen.

Si applica a

SetColorKey(Color, Color, ColorAdjustType)

Imposta la chiave di colore (intervallo di trasparenza) per una categoria specificata.

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)

Parametri

colorLow
Color

Valore minimo della chiave di colore.

colorHigh
Color

Valore massimo della chiave di colore.

type
ColorAdjustType

Elemento dell'oggetto ColorAdjustType da cui viene specificata la categoria per la quale viene impostata la chiave di colore.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgs e , che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

  1. Apre un oggetto Image che utilizza il file Circle.bmp e lo disegna sullo schermo.

  2. Crea un ImageAttributes oggetto e ne imposta la chiave di colore chiamando il SetColorKey metodo.

  3. Disegna l'immagine sullo schermo usando la chiave di colore dell' ImageAttributes oggetto.

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

Commenti

Questo metodo imposta i valori della chiave di colore alta e bassa in modo che sia possibile rendere trasparente un intervallo di colori. Qualsiasi colore con ognuno dei tre componenti (rosso, verde, blu) tra i componenti corrispondenti delle chiavi di colore alta e bassa viene reso trasparente.

Un ImageAttributes oggetto mantiene le impostazioni relative ai colori e alle gradazioni di grigio per cinque categorie di regolazione: predefinita, bitmap, pennello, penna e testo. È ad esempio possibile specificare una chiave di colore per la categoria predefinita, una chiave di colore diversa per la categoria bitmap e ancora una chiave di colore diversa per la categoria Pen.

Le impostazioni predefinite per la regolazione del colore e la regolazione delle gradazioni di grigio si applicano a tutte le categorie per le quali non sono disponibili impostazioni di regolazione. Se, ad esempio, non si specificano mai impostazioni di regolazione per la categoria Pen, le impostazioni predefinite verranno applicate alla categoria Pen.

Non appena si specifica un'impostazione di regolazione del colore o di regolazione delle gradazioni di grigio per una determinata categoria, le impostazioni di regolazione predefinite non sono più valide per tale categoria. Si supponga, ad esempio, di specificare una raccolta di impostazioni di regolazione per la categoria predefinita. Se si imposta la chiave di colore per la categoria Pen passando Pen al SetColorKey metodo, nessuna delle impostazioni di regolazione predefinite si applicherà alle penne.

Si applica a