ImageAttributes.SetColorKey Metodo

Definizione

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
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs
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);

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 = 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);      
}

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.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetColorKey(Color, Color)

Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs
Origine:
ImageAttributes.cs

Imposta la chiave di colore per la categoria predefinita.

public void SetColorKey (System.Drawing.Color colorLow, System.Drawing.Color colorHigh);

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.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9