Compartilhar via

Form.Opacity Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define o nível de opacidade do formulário.

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 da propriedade

Double

O nível de opacidade do formulário. O padrão é 1.00.

Atributos
TypeConverterAttribute

Exemplos

O exemplo a seguir demonstra como criar um formulário exibido com um nível de opacidade de 75%. Ele cria um novo formulário posicionado no centro da tela 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 uma forma de tamanho maior do que o tamanho padrão do formulário.

Este exemplo pressupõe que o CreateMyOpaqueForm método é chamado de outro formulário em um manipulador 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

Comentários

A Opacity propriedade permite que você especifique um nível de transparência para o formulário e seus controles. Quando essa propriedade é definida como um valor inferior a 100% (1,00), toda a forma, incluindo bordas, torna-se mais transparente. Definir essa propriedade como um valor de 0% (0,00) torna o formulário completamente invisível. Você pode usar essa propriedade para fornecer diferentes níveis de transparência ou para fornecer efeitos como a eliminação de um formulário dentro ou fora de exibição. Por exemplo, você pode colocar um formulário em fases em exibição definindo a Opacity propriedade como um valor de 0% (0,00) e aumentando gradualmente o valor até atingir 100% (1,00).

Opacity difere da transparência fornecida por TransparencyKey, que só torna um formulário e seus controles completamente transparentes se forem da mesma cor que o valor especificado na TransparencyKey propriedade .

Essa propriedade não tem suporte quando RightToLeftLayout é true.

A Opacity propriedade depende da API do Windows em camadas. Para obter mais informações, consulte Windows em camadas.

Aplica-se a

Confira também