Form.TransparencyKey Propiedad

Definición

Obtiene o establece el color que representará las áreas transparentes del formulario.Gets or sets the color that will represent transparent areas of the form.

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 que representa el color que va a aparecer transparente en el formulario.A Color that represents the color to display transparently on the form.

Ejemplos

En el ejemplo siguiente se crea una ventana que tiene una región de cliente transparente independientemente del color de fondo del formulario.The following example creates a window that has a transparent client region regardless of background color of the form. Este ejemplo requiere que el método de ejemplo esté definido dentro de una clase de formulario.This example requires that the example method is defined within a form class.

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 un Colora la propiedad TransparencyKey, las áreas del formulario que tienen el mismo BackColor se mostrarán de forma transparente.When the TransparencyKey property is assigned a Color, the areas of the form that have the same BackColor will be displayed transparently. Cualquier acción del mouse, como el clic del mouse, que se realice en las áreas transparentes del formulario se transferirá a las ventanas situadas debajo del área transparente.Any mouse actions, such as the click of the mouse, that are performed on the transparent areas of the form will be transferred to the windows below the transparent area. Por ejemplo, si la región de cliente de un formulario se hace transparente, al hacer clic en el mouse en esa área se enviaría la notificación de eventos del clic a cualquier ventana que esté debajo de ella.For example, if the client region of a form is made transparent, clicking the mouse on that area would send the event notification of the click to any window that is below it. Si el color asignado a la propiedad TransparencyKey es el mismo que el de los controles del formulario, también se mostrarán de forma transparente.If the color assigned to the TransparencyKey property is the same as any controls on the form, they also will be displayed transparently. Por ejemplo, si tiene un control Button en un formulario que tiene su propiedad TransparencyKey establecida en SystemColors.Control, el control se mostrará de forma transparente a menos que la propiedad BackColor del control Button se cambie a un color diferente.For example, if you have a Button control on a form that has its TransparencyKey property set to SystemColors.Control, the control will be displayed transparently unless the BackColor property of the Button control is changed to a different color.

Esta propiedad no se admite cuando se trueRightToLeftLayout.This property is not supported when RightToLeftLayout is true.

Se aplica a