Form.TransparencyKey Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Farbe ab, in der transparente Bereiche des Formulars dargestellt werden, oder legt diese fest.

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

Eine Color, die die Farbe für eine transparente Anzeige im Formular darstellt.

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 innerhalb 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 ein Colorzugewiesen wird, werden die Bereiche des Formulars, die dasselbe BackColor aufweisen, transparent angezeigt. Alle Mausaktionen, z. B. das Klicken der Maus, die auf den transparenten Bereichen des Formulars ausgeführt werden, werden in die Fenster unterhalb des transparenten Bereichs übertragen. Wenn beispielsweise der Clientbereich eines Formulars transparent gemacht wird, sendet ein Mausklick auf diesen Bereich die Ereignisbenachrichtigung über das Klicken an ein fenster, das sich darunter befindet. Wenn die der TransparencyKey -Eigenschaft zugewiesene Farbe mit allen Steuerelementen im Formular identisch ist, werden sie auch transparent angezeigt. Wenn Sie beispielsweise ein Steuerelement für ein Button Formular haben, dessen TransparencyKey Eigenschaft auf SystemColors.Controlfestgelegt ist, wird das Steuerelement transparent angezeigt, es sei denn, die BackColor Eigenschaft des Button Steuerelements wird in eine andere Farbe geändert.

Diese Eigenschaft wird nicht unterstützt, wenn RightToLeftLayout ist true.