Form.TransparencyKey Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

Form.cs

Obtient ou définit la couleur qui représente les zones transparentes du formulaire.

public:
 property System::Drawing::Color TransparencyKey { System::Drawing::Color get(); void set(System::Drawing::Color value); };

public System.Drawing.Color TransparencyKey { get; set; }

member this.TransparencyKey : System.Drawing.Color with get, set

Public Property TransparencyKey As Color

Valeur de propriété

Color

Qui Color représente la couleur à afficher de manière transparente sur le formulaire.

Exemples

L’exemple suivant crée une fenêtre qui a une région cliente transparente, quelle que soit la couleur d’arrière-plan du formulaire. Cet exemple nécessite que l’exemple de méthode soit défini dans une classe de formulaire.

public:
   void InitializeMyForm()
   {
      this->BackColor = Color::Red;
      // Make the background color of form display transparently.
      this->TransparencyKey = BackColor;
   }

public void InitializeMyForm()
 {
    this.BackColor = Color.Red;
    // Make the background color of form display transparently.
    this.TransparencyKey = BackColor;
 }

Public Sub InitializeMyForm()
    BackColor = Color.Red
    ' Make the background color of form display transparently.
    TransparencyKey = BackColor
End Sub

Remarques

Lorsque la TransparencyKey propriété est affectée, Colorles zones du formulaire qui ont la même BackColor valeur s’affichent de manière transparente. Toutes les actions de souris, telles que le clic de la souris, qui sont effectuées sur les zones transparentes du formulaire seront transférées vers les fenêtres situées sous la zone transparente. Par exemple, si la zone cliente d’un formulaire est transparente, le fait de cliquer sur la souris sur cette zone enverrait la notification d’événement du clic à n’importe quelle fenêtre située en dessous. Si la couleur affectée à la TransparencyKey propriété est identique à tous les contrôles du formulaire, elles sont également affichées de manière transparente. Par exemple, si vous avez un Button contrôle sur un formulaire dont la TransparencyKey propriété est définie SystemColors.Control, le contrôle s’affiche de manière transparente, sauf si la BackColor propriété du Button contrôle est modifiée en couleur différente.

Cette propriété n’est pas prise en charge quand RightToLeftLayout est true.