ImageAttributes.SetColorKey Metodo

Definizione

Spazio dei nomi:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

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 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 Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

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

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

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 elevati e bassi in modo che sia possibile rendere trasparente un intervallo di colori. Qualsiasi colore che ha ognuno dei suoi tre componenti (rosso, verde, blu) tra i componenti corrispondenti delle chiavi di colore elevate e basse è reso trasparente.

Un ImageAttributes oggetto gestisce le impostazioni di colore e scala di grigio per cinque categorie di regolazione: impostazione 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 di penna.

Le impostazioni predefinite di regolazione dei colori e di regolazione della scala grigia si applicano a tutte le categorie che non hanno impostazioni di regolazione personalizzate. Ad esempio, se non si specificano mai impostazioni di regolazione per la categoria di penna, le impostazioni predefinite si applicano alla categoria di penna.

Non appena si specifica un'impostazione di regolazione del colore o di regolazione della scala grigia 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 di penna passando Pen al SetColorKey metodo, 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 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 di chiave a colori elevati e bassi in modo che sia possibile rendere trasparente un intervallo di colori. Qualsiasi colore che ha ognuno dei suoi tre componenti (rosso, verde, blu) tra i componenti corrispondenti delle chiavi di colore elevate e basse è reso trasparente.

Un ImageAttributes oggetto gestisce le impostazioni di colore e scala di grigio per cinque categorie di regolazione: impostazione 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 di penna.

Le impostazioni predefinite di regolazione dei colori e di regolazione della scala grigia si applicano a tutte le categorie che non hanno impostazioni di regolazione personalizzate. Ad esempio, se non si specificano mai impostazioni di regolazione per la categoria di penna, le impostazioni predefinite si applicano alla categoria di penna.