Form.TransparencyKey Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

Form.cs

Dient zum Abrufen oder Festlegen der Farbe, die transparente Bereiche des Formulars darstellt.

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

Eigenschaftswert

Color

A Color that represents the color to displayly on the form.

Beispiele

Im folgenden Beispiel wird ein Fenster erstellt, das unabhängig von der Hintergrundfarbe des Formulars über einen transparenten Clientbereich verfügt. Dieses Beispiel erfordert, dass die Beispielmethode in einer Formularklasse definiert ist.

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

Hinweise

Wenn der TransparencyKey Eigenschaft eine ColorEigenschaft zugewiesen wird, werden die Bereiche des Formulars, die dasselbe BackColor aufweisen, transparent angezeigt. Alle Mausaktionen, z. B. der Mausklick, die auf den transparenten Bereichen des Formulars ausgeführt werden, werden an die Fenster unterhalb des transparenten Bereichs übertragen. Wenn beispielsweise der Clientbereich eines Formulars transparent gemacht wird, würde durch Klicken auf die Maus auf diesem Bereich die Ereignisbenachrichtigung des Klickens an ein darunter liegendes Fenster gesendet. Wenn die der Eigenschaft zugewiesene TransparencyKey Farbe mit allen Steuerelementen im Formular identisch ist, werden sie auch transparent angezeigt. Wenn Sie beispielsweise ein Button Steuerelement in einem Formular haben, auf das seine TransparencyKey Eigenschaft festgelegt SystemColors.Controlist, wird das Steuerelement transparent angezeigt, es sei denn, die BackColor Eigenschaft des Button Steuerelements wird in eine andere Farbe geändert.

Diese Eigenschaft wird in diesem Fall RightToLeftLayouttruenicht unterstützt.