Form.Opacity Propiedad

Definición

Obtiene o establece el nivel de opacidad del formulario.Gets or sets the opacity level of the form.

public:
 property double Opacity { double get(); void set(double value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.OpacityConverter))]
public double Opacity { get; set; }
member this.Opacity : double with get, set
Public Property Opacity As Double

Valor de propiedad

Double

Nivel de opacidad del formulario.The level of opacity for the form. El valor predeterminado es 1,00.The default is 1.00.

Atributos

Ejemplos

En el ejemplo siguiente se muestra cómo crear un formulario que se muestra con un nivel de opacidad del 75 por ciento.The following example demonstrates how to create a form that is displayed with an opacity level of 75 percent. Crea un nuevo formulario que se coloca en el centro de la pantalla con una propiedad Opacity establecida para cambiar el nivel de opacidad del formulario.It creates a new form that is positioned in the center of the screen with an Opacity property set to change the opacity level of the form. En el ejemplo también se establece la propiedad Size para proporcionar un formulario de mayor tamaño que el tamaño predeterminado del formulario.The example also sets the Size property to provide a larger sized form than the default size of the form.

En este ejemplo se da por supuesto que se llama al método CreateMyOpaqueForm desde otro formulario en un controlador de eventos u otro método.This example assumes that the CreateMyOpaqueForm method is called from another form in an event handler or other method.

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 propiedad Opacity permite especificar un nivel de transparencia para el formulario y sus controles.The Opacity property enables you to specify a level of transparency for the form and its controls. Cuando esta propiedad se establece en un valor inferior al 100 por ciento (1,00), el formulario completo, incluidos los bordes, se hace más transparente.When this property is set to a value less than 100 percent (1.00), the entire form, including borders, is made more transparent. Establecer esta propiedad en un valor de 0 por ciento (0,00) hace que el formulario sea completamente invisible.Setting this property to a value of 0 percent (0.00) makes the form completely invisible. Puede usar esta propiedad para proporcionar diferentes niveles de transparencia o para proporcionar efectos como la fase de un formulario dentro o fuera de la vista.You can use this property to provide different levels of transparency or to provide effects such as phasing a form in or out of view. Por ejemplo, puede aplicar una fase a la vista mediante la configuración de la propiedad Opacity en un valor de 0 por ciento (0,00) e incrementar gradualmente el valor hasta que alcance el 100 por ciento (1,00).For example, you can phase a form into view by setting the Opacity property to a value of 0 percent (0.00) and gradually increasing the value until it reaches 100 percent (1.00).

Opacity difiere de la transparencia proporcionada por TransparencyKey, que solo hace que un formulario y sus controles sean completamente transparentes si tienen el mismo color que el valor especificado en la propiedad TransparencyKey.Opacity differs from the transparency provided by TransparencyKey, which only makes a form and its controls completely transparent if they are the same color as the value specified in the TransparencyKey property.

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

La propiedad Opacity depende de la API de Windows superpuesta.The Opacity property depends on the Layered Windows API. Para obtener más información, consulte ventanas superpuestas.For more information, see Layered Windows.

Se aplica a

Consulte también: