Form.Opacity Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el nivel de opacidad del formulario.

public:
 property double Opacity { double get(); void set(double value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.OpacityConverter))]
public double Opacity { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.OpacityConverter))>]
member this.Opacity : double with get, set

Public Property Opacity As Double

Valor de propiedad

Double

Nivel de opacidad del formulario. El valor predeterminado es 1,00.

Atributos

TypeConverterAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo crear un formulario que se muestra con un nivel de opacidad del 75 %. Crea un formulario que se coloca en el centro de la pantalla con una Opacity propiedad establecida para cambiar el nivel de opacidad del formulario. En el ejemplo también se establece la Size propiedad para proporcionar un formulario de mayor tamaño que el tamaño predeterminado del formulario.

En este ejemplo se supone que se llama al CreateMyOpaqueForm método desde otro formulario en un controlador de eventos u otro método.

private:
   void CreateMyOpaqueForm()
   {
      // Create a new form.
      Form^ form2 = gcnew Form;

      // Set the text displayed in the caption.
      form2->Text = "My Form";

      // Set the opacity to 75%.
      form2->Opacity = .75;

      // Size the form to be 300 pixels in height and width.
      form2->Size = System::Drawing::Size( 300, 300 );

      // Display the form in the center of the screen.
      form2->StartPosition = FormStartPosition::CenterScreen;

      // Display the form as a modal dialog box.
      form2->ShowDialog();
   }

private void CreateMyOpaqueForm()
{
   // Create a new form.
   Form form2 = new Form();
   // Set the text displayed in the caption.
   form2.Text = "My Form";
   // Set the opacity to 75%.
   form2.Opacity = .75;
   // Size the form to be 300 pixels in height and width.
   form2.Size = new Size(300,300);
   // Display the form in the center of the screen.
   form2.StartPosition = FormStartPosition.CenterScreen;

   // Display the form as a modal dialog box.
   form2.ShowDialog();
}

Private Sub CreateMyOpaqueForm()
   ' Create a new form.
   Dim form2 As New Form()
   ' Set the text displayed in the caption.
   form2.Text = "My Form"
   ' Set the opacity to 75%.
   form2.Opacity = 0.75
   ' Size the form to be 300 pixels in height and width.
   form2.Size = New Size(300, 300)
   ' Display the form in the center of the screen.
   form2.StartPosition = FormStartPosition.CenterScreen

   ' Display the form as a modal dialog box.
   form2.ShowDialog()
End Sub

Comentarios

La Opacity propiedad permite especificar un nivel de transparencia para el formulario y sus controles. Cuando esta propiedad se establece en un valor inferior al 100 por ciento (1,00), todo el formulario, incluidos los bordes, se hace más transparente. Establecer esta propiedad en un valor de 0 por ciento (0,00) hace que el formulario sea completamente invisible. Puede usar esta propiedad para proporcionar diferentes niveles de transparencia o para proporcionar efectos como la eliminación gradual de un formulario en o fuera de la vista. Por ejemplo, puede realizar una fase de un formulario en la vista estableciendo la Opacity propiedad en un valor del 0 por ciento (0,00) y aumentando gradualmente el valor hasta alcanzar el 100 por ciento (1,00).

Opacity difiere de la transparencia proporcionada por TransparencyKey, que solo hace que un formulario y sus controles sean completamente transparentes si son del mismo color que el valor especificado en la TransparencyKey propiedad .

Esta propiedad no se admite cuando RightToLeftLayout es true.

La Opacity propiedad depende de la API de Windows superpuesta. Para obtener más información, vea Ventanas superpuestas.

Consulte también

• TransparencyKey
• LayeredWindows