Form.TransparencyKey Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property TransparencyKey As ColorEigenschaftswert
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.
