Form.Opacity Propriedade

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 Propriedade

O nível de opacidade da forma. O padrão é 1.00.

Atributos

TypeConverterAttribute

Exemplos

O exemplo seguinte demonstra como criar um formulário que é exibido com um nível de opacidade de 75 por cento. Cria um novo formulário que está posicionado no centro do ecrã com uma Opacity propriedade definida para alterar o nível de opacidade do formulário. O exemplo também define a Size propriedade para fornecer um formulário de tamanho maior do que o tamanho padrão do formulário.

Este exemplo assume que o CreateMyOpaqueForm método é chamado a partir de outra forma num gestor de eventos ou outro 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

Observações

A Opacity propriedade permite-lhe especificar um nível de transparência para o formulário e os seus controlos. Quando esta propriedade é definida para um valor inferior a 100 por cento (1,00), toda a forma, incluindo as bordas, torna-se mais transparente. Definir esta propriedade para um valor de 0 por cento (0,00) torna a forma completamente invisível. Pode usar esta propriedade para fornecer diferentes níveis de transparência ou para obter efeitos como a introdução ou saída de uma forma de vista. Por exemplo, pode colocar um formulário em fase de visualização definindo a Opacity propriedade para um valor de 0 por cento (0,00) e aumentando gradualmente o valor até atingir 100 por cento (1,00).

Opacity difere da transparência fornecida por TransparencyKey, que só torna uma forma e os seus controlos completamente transparentes se forem da mesma cor do valor especificado na TransparencyKey propriedade.

Esta propriedade não é suportada quando RightToLeftLayout é true.

A propriedade Opacity depende da API de Windows em camadas. Para mais informações, veja Layered Windows.

Ver também

• TransparencyKey
• LayeredWindows