Form.TransparencyKey-Eigenschaft
Ruft die Farbe ab, in der transparente Bereiche des Formulars darstellt werden, oder legt diese fest.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
Public Property TransparencyKey As Color
'Usage
Dim instance As Form
Dim value As Color
value = instance.TransparencyKey
instance.TransparencyKey = value
public Color TransparencyKey { get; set; }
public:
property Color TransparencyKey {
Color get ();
void set (Color value);
}
/** @property */
public Color get_TransparencyKey ()
/** @property */
public void set_TransparencyKey (Color value)
public function get TransparencyKey () : Color
public function set TransparencyKey (value : Color)
Eigenschaftenwert
Eine Color, die die Farbe für die transparente Anzeige im Formular darstellt.
Hinweise
Wenn der TransparencyKey-Eigenschaft eine Color zugewiesen wird, werden die Bereiche im Formular mit derselben BackColor transparent angezeigt. Alle Mausaktionen, z. B. ein Mausklick, die für die transparenten Bereiche des Formulars ausgeführt werden, werden an die Fenster weitergegeben, die sich unter dem transparenten Bereich befinden. Wenn beispielsweise der Clientbereich eines Formulars transparent ist, wird die Ereignisbenachrichtigung für einen Mausklick in diesem Bereich an das jeweils darunter befindliche Fenster gesendet. Wenn die der TransparencyKey-Eigenschaft zugewiesene Farbe mit der anderer Steuerelemente im Formular übereinstimmt, werden diese ebenfalls transparent angezeigt. Wenn in einem Formular beispielsweise ein Button-Steuerelement vorhanden ist, dessen TransparencyKey-Eigenschaft auf SystemColors.Control festgelegt ist, wird dieses Steuerelement transparent angezeigt, sofern nicht die BackColor-Eigenschaft des Button-Steuerelements auf eine andere Farbe festgelegt wird.
Diese Eigenschaft wird nicht unterstützt, wenn RightToLeftLayouttrue ist.
Hinweis zu Windows 2000, Windows Server 2003, Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003: Transparente Fenster und Bereiche werden nur ab Windows 2000 unterstützt.
Beispiel
Im folgenden Codebeispiel wird ein Fenster erstellt, das unabhängig von der Hintergrundfarbe des Formulars über einen transparenten Clientbereich verfügt. Für dieses Beispiel ist es erforderlich, dass die Beispielmethode in einer Formularklasse definiert ist.
Public Sub InitializeMyForm()
BackColor = Color.Red
' Make the background color of form display transparently.
TransparencyKey = BackColor
End Sub 'InitializeMyForm
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 void InitializeMyForm()
{
this.set_BackColor(Color.get_Red());
// Make the background color of form display transparently.
this.set_TransparencyKey(this.get_BackColor());
} //InitializeMyForm
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0