ImageAttributes.SetColorKey Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit la clé de couleur (plage de transparence).
Surcharges
SetColorKey(Color, Color, ColorAdjustType) |
Définit la clé de couleur (plage de transparence) pour une catégorie spécifiée. |
SetColorKey(Color, Color) |
Définit la clé de couleur pour la catégorie par défaut. |
SetColorKey(Color, Color, ColorAdjustType)
Définit la clé de couleur (plage de transparence) pour une catégorie spécifiée.
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)
Paramètres
- colorLow
- Color
Valeur de clé de couleur basse.
- colorHigh
- Color
Valeur de clé de couleur haute.
- type
- ColorAdjustType
Élément de ColorAdjustType qui spécifie la catégorie pour laquelle la clé de couleur est définie.
Exemples
L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse
, qui est un paramètre du Paint gestionnaire d’événements. Le code effectue les actions suivantes :
Ouvre un Image qui utilise le fichier Circle.bmp et le dessine à l’écran.
Crée un ImageAttributes objet et définit sa clé de couleur en appelant la SetColorKey méthode .
Dessine l’image vers l’écran à l’aide de la touche de couleur de l’objet 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
Remarques
Cette méthode définit les valeurs de touche de couleur haute et basse afin qu’une plage de couleurs puisse être rendue transparente. Toute couleur qui a chacun de ses trois composants (rouge, vert, bleu) entre les composants correspondants des touches de couleur haute et basse est rendue transparente.
Un ImageAttributes objet conserve les paramètres de couleur et de nuances de gris pour cinq catégories d’ajustement : par défaut, bitmap, pinceau, stylet et texte. Par exemple, vous pouvez spécifier une clé de couleur pour la catégorie par défaut, une autre clé de couleur pour la catégorie bitmap et une autre clé de couleur pour la catégorie de stylet.
Les paramètres d’ajustement des couleurs et de réglage des nuances de gris par défaut s’appliquent à toutes les catégories qui n’ont pas de paramètres d’ajustement propres. Par exemple, si vous ne spécifiez jamais de paramètres d’ajustement pour la catégorie de stylet, les paramètres par défaut s’appliquent à la catégorie de stylet.
Dès que vous spécifiez un paramètre de réglage des couleurs ou de réglage des nuances de gris pour une catégorie donnée, les paramètres d’ajustement par défaut ne s’appliquent plus à cette catégorie. Par exemple, supposons que vous spécifiez une collection de paramètres d’ajustement pour la catégorie par défaut. Si vous définissez la touche de couleur pour la catégorie de stylet en passant Pen à la SetColorKey méthode, aucun des paramètres d’ajustement par défaut ne s’applique aux stylets.
S’applique à
SetColorKey(Color, Color)
Définit la clé de couleur pour la catégorie par défaut.
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)
Paramètres
- colorLow
- Color
Valeur de clé de couleur basse.
- colorHigh
- Color
Valeur de clé de couleur haute.
Exemples
Pour obtenir un exemple de code, consultez la SetColorKey(Color, Color, ColorAdjustType) méthode .
Remarques
Cette méthode définit les valeurs de touche de couleur haute et basse afin qu’une plage de couleurs puisse être rendue transparente. Toute couleur qui a chacun de ses trois composants (rouge, vert, bleu) entre les composants correspondants des touches de couleur haute et basse est rendue transparente.
Un ImageAttributes objet conserve les paramètres de couleur et de nuances de gris pour cinq catégories d’ajustement : par défaut, bitmap, pinceau, stylet et texte. Par exemple, vous pouvez spécifier une clé de couleur pour la catégorie par défaut, une autre clé de couleur pour la catégorie bitmap et une autre clé de couleur pour la catégorie de stylet.
Les paramètres d’ajustement des couleurs et de réglage des nuances de gris par défaut s’appliquent à toutes les catégories qui n’ont pas de paramètres d’ajustement propres. Par exemple, si vous ne spécifiez jamais de paramètres d’ajustement pour la catégorie de stylet, les paramètres par défaut s’appliquent à la catégorie de stylet.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : tout au long de 2024, nous allons éliminer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d'informations, consultez :Envoyer et afficher des commentaires pour