Form.TransparencyKey Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit la couleur qui représentera 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

Color qui représente la couleur transparente à afficher 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 le même BackColor s’affichent en toute transparence. Toutes les actions de la souris, telles que le clic de la souris, qui sont effectuées sur les zones transparentes du formulaire sont transférées vers les fenêtres situées sous la zone transparente. Par exemple, si la zone cliente d’un formulaire est rendue transparente, le fait de cliquer sur la souris sur cette zone envoie 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 à celle des contrôles du formulaire, ils s’affichent également en toute transparence. Par exemple, si vous avez un Button contrôle sur un formulaire dont la TransparencyKey propriété est définie SystemColors.Controlsur , le contrôle s’affiche en toute transparence, sauf si la BackColorButton propriété du contrôle est modifiée vers une couleur différente.

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