Form.TransparencyKey Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el color que representará las áreas transparentes del formulario.

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

Valor de propiedad

Color

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

Ejemplos

En el ejemplo siguiente se crea una ventana que tiene una región de cliente transparente, independientemente del color de fondo del formulario. En este ejemplo se requiere que el método de ejemplo se defina dentro de una clase de formulario.

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

Comentarios

Cuando se asigna a la TransparencyKey propiedad , Colorlas áreas del formulario que tienen la misma BackColor se mostrarán de forma transparente. Cualquier acción del mouse, como el clic del mouse, que se realice en las áreas transparentes del formulario se transferirá a las ventanas debajo del área transparente. Por ejemplo, si el área de cliente de un formulario se hace transparente, al hacer clic en el mouse de esa área, se enviará la notificación de eventos del clic a cualquier ventana que esté debajo de él. Si el color asignado a la TransparencyKey propiedad es el mismo que los controles del formulario, también se mostrarán de forma transparente. Por ejemplo, si tiene un Button control en un formulario que tiene su TransparencyKey propiedad establecida SystemColors.Controlen , el control se mostrará de forma transparente a menos que la BackColor propiedad del Button control cambie a un color diferente.

Esta propiedad no se admite cuando RightToLeftLayout es true.