ImageAttributes.SetColorKey Metodo

Definizione

Spazio dei nomi:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v9.0.0-rc.1.24451.1

Imposta la chiave di colore (intervallo di trasparenza).

Overload

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.

SetColorKey(Color, Color, ColorAdjustType)

Origine:

ImageAttributes.cs

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 della chiave a colori basso.

colorHigh

Color

Valore della chiave a colori elevato.

type

ColorAdjustType

Elemento di ColorAdjustType che specifica la categoria per cui è impostata la chiave di colore.

Esempio

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

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

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

3. Disegna l'immagine sullo schermo usando la chiave di colore dell'oggetto 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

Commenti

Questo metodo imposta i valori di chiave a colori alti e bassi in modo che un intervallo di colori possa essere reso trasparente. Qualsiasi colore con ognuno dei suoi tre componenti (rosso, verde, blu) tra i componenti corrispondenti dei tasti di colore alto e basso viene reso trasparente.

Un oggetto ImageAttributes mantiene le impostazioni di colore e gradazioni di grigio per cinque categorie di regolazione: default, bitmap, brush, pen e text. 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 di penna.

Le impostazioni predefinite per la regolazione del colore e la regolazione della scala di grigi si applicano a tutte le categorie che non dispongono di impostazioni di regolazione personalizzate. Ad esempio, se non si specificano mai impostazioni di regolazione per la categoria della penna, le impostazioni predefinite si applicano alla categoria della penna.

Non appena si specifica un'impostazione di regolazione del colore o di regolazione della scala di grigi per una determinata categoria, le impostazioni di regolazione predefinite non si applicano più a 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 della penna passando Pen al metodo SetColorKey, nessuna delle impostazioni di regolazione predefinite verrà applicata alle penne.

SetColorKey(Color, Color)

Origine:

ImageAttributes.cs

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 della chiave a colori basso.

colorHigh

Color

Valore della chiave a colori elevato.

Esempio

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

Commenti

Questo metodo imposta i valori di chiave a colori alti e bassi in modo che un intervallo di colori possa essere reso trasparente. Qualsiasi colore con ognuno dei suoi tre componenti (rosso, verde, blu) tra i componenti corrispondenti dei tasti di colore alto e basso viene reso trasparente.

Un oggetto ImageAttributes mantiene le impostazioni di colore e gradazioni di grigio per cinque categorie di regolazione: default, bitmap, brush, pen e text. 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 di penna.

Le impostazioni predefinite per la regolazione del colore e la regolazione della scala di grigi si applicano a tutte le categorie che non dispongono di impostazioni di regolazione personalizzate. Ad esempio, se non si specificano mai impostazioni di regolazione per la categoria della penna, le impostazioni predefinite si applicano alla categoria della penna.