Form.TransparencyKey (Propiedad)
Obtiene o establece el color que representará las áreas transparentes del formulario.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

Sintaxis

Visual Basic (Declaración)
Public Property TransparencyKey As Color
Visual Basic (Uso)
Dim instance As Form
Dim value As Color

value = instance.TransparencyKey

instance.TransparencyKey = value
C#
public Color TransparencyKey { get; set; }
C++
public:
property Color TransparencyKey {
    Color get ();
    void set (Color value);
}
J#
/** @property */
public Color get_TransparencyKey ()

/** @property */
public void set_TransparencyKey (Color value)
JScript
public function get TransparencyKey () : Color

public function set TransparencyKey (value : Color)
XAML
No aplicable.

Valor de propiedad

Color que representa el color que va a aparecer transparente en el formulario.
Comentarios

Si a la propiedad TransparencyKey se le asigna un Color, las áreas del formulario que tengan el mismo BackColor se mostrarán transparentes. Las acciones del mouse (ratón), por ejemplo hacer clic, que se lleven a cabo en las áreas transparentes del formulario se transferirán a las ventanas situadas debajo de estas áreas. Por ejemplo, si el área de cliente de un formulario es transparente, al hacer clic con el mouse en ella se enviará la notificación del evento a la ventana que esté situada debajo. Si el color asignado a la propiedad TransparencyKey es el mismo que el de los controles del formulario, estos controles también se mostrarán transparentes. Por ejemplo, si hay un control Button en un formulario que tiene la propiedad TransparencyKey establecida en SystemColors.Control, el control aparecerá transparente a menos que la propiedad BackColor del control Button se cambie a otro color.

Esta propiedad no es compatible cuando RightToLeftLayout es true.

Nota de la plataforma Windows 2000, Windows Server 2003, Windows XP Home, Windows XP Professional x64, Windows Server 2003: Las ventanas y áreas transparentes sólo se admiten a partir de Windows 2000.

Ejemplo

En el ejemplo de código siguiente se crea una ventana con una región cliente transparente independientemente del color de fondo del formulario. En este ejemplo se requiere que el método esté definido dentro de una clase de formulario.

Visual Basic
Public Sub InitializeMyForm()
    BackColor = Color.Red
    ' Make the background color of form display transparently.
    TransparencyKey = BackColor
End Sub 'InitializeMyForm
C#
public void InitializeMyForm()
 {
    this.BackColor = Color.Red;
    // Make the background color of form display transparently.
    this.TransparencyKey = BackColor;
 }
    
C++
public:
   void InitializeMyForm()
   {
      this->BackColor = Color::Red;
      // Make the background color of form display transparently.
      this->TransparencyKey = BackColor;
   }
J#
public void InitializeMyForm()
{
    this.set_BackColor(Color.get_Red());

    // Make the background color of form display transparently.
    this.set_TransparencyKey(this.get_BackColor());
} //InitializeMyForm
Plataformas

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

Información de versión

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Vea también

Page view tracker