Form.Opacity Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta il livello di opacità del form.

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

Valore della proprietà

Double

Livello di opacità del form. Il valore predefinito è 1,00.

Attributi
TypeConverterAttribute

Esempio

Nell'esempio seguente viene illustrato come creare un modulo visualizzato con un livello di opacità del 75%. Crea un nuovo modulo posizionato al centro dello schermo con una Opacity proprietà impostata per modificare il livello di opacità del modulo. Nell'esempio viene inoltre impostata la Size proprietà per fornire un formato di dimensioni maggiori rispetto alle dimensioni predefinite del modulo.

In questo esempio si presuppone che il CreateMyOpaqueForm metodo venga chiamato da un altro modulo in un gestore eventi o in un altro metodo.

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

Commenti

La Opacity proprietà consente di specificare un livello di trasparenza per il form e i relativi controlli. Quando questa proprietà è impostata su un valore inferiore al 100% (1,00), l'intero modulo, inclusi i bordi, viene reso più trasparente. L'impostazione di questa proprietà su un valore pari a 0% (0,00) rende il form completamente invisibile. È possibile utilizzare questa proprietà per fornire diversi livelli di trasparenza o per fornire effetti come la suddivisione in fasi di una maschera in o in visualizzazione. Ad esempio, è possibile eseguire la fase di visualizzazione di un modulo impostando la Opacity proprietà su un valore pari a 0% (0,00) e aumentando gradualmente il valore fino a raggiungere il 100% (1,00).

Opacity differisce dalla trasparenza fornita da TransparencyKey, che rende trasparente solo una maschera e i relativi controlli completamente trasparenti se sono lo stesso colore del valore specificato nella TransparencyKey proprietà .

Questa proprietà non è supportata quando RightToLeftLayout è true.

La Opacity proprietà dipende dall'API Windows a più livelli. Per altre informazioni, vedere Windows a più livelli.

Si applica a

Vedi anche