Form.TransparencyKey Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia kolor, który będzie reprezentować przezroczyste obszary formularza.

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

Wartość właściwości

Color

Obiekt Color reprezentujący kolor wyświetlany w przezroczysty sposób na formularzu.

Przykłady

Poniższy przykład tworzy okno z przezroczystym regionem klienta niezależnie od koloru tła formularza. Ten przykład wymaga, aby przykładowa metoda została zdefiniowana w klasie formularza.

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

Uwagi

TransparencyKey Gdy właściwość ma przypisaną Colorwłaściwość , obszary formularza, które mają takie sameBackColor, będą wyświetlane w przezroczysty sposób. Wszelkie akcje myszy, takie jak kliknięcie myszy, wykonywane na przezroczystych obszarach formularza, zostaną przeniesione do okien poniżej przezroczystego obszaru. Jeśli na przykład region klienta formularza jest niewidoczny, kliknięcie myszy w tym obszarze spowoduje wysłanie powiadomienia o zdarzeniu kliknięcia do dowolnego okna znajdującego się pod nim. Jeśli kolor przypisany do TransparencyKey właściwości jest taki sam jak wszystkie kontrolki w formularzu, będą one również wyświetlane w przezroczysty sposób. Jeśli na przykład masz kontrolkę Button w formularzu, który ma jego TransparencyKey właściwość ustawioną na SystemColors.Control, kontrolka będzie wyświetlana w sposób niewidoczny, chyba że BackColor właściwość kontrolki Button zostanie zmieniona na inny kolor.

Ta właściwość nie jest obsługiwana, gdy RightToLeftLayout ma wartość true.