Form.Opacity Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit le niveau d'opacité du formulaire.

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

Valeur de propriété

Double

Niveau d'opacité du formulaire. La valeur par défaut est 1,00.

Attributs

TypeConverterAttribute

Exemples

L’exemple suivant montre comment créer un formulaire qui s’affiche avec un niveau d’opacité de 75 %. Il crée un nouveau formulaire qui est positionné au centre de l’écran avec une Opacity propriété définie pour modifier le niveau d’opacité du formulaire. L’exemple définit également la Size propriété pour fournir un formulaire de taille supérieure à la taille par défaut du formulaire.

Cet exemple suppose que la CreateMyOpaqueForm méthode est appelée à partir d’un autre formulaire dans un gestionnaire d’événements ou une autre méthode.

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

Remarques

La Opacity propriété vous permet de spécifier un niveau de transparence pour le formulaire et ses contrôles. Lorsque cette propriété est définie sur une valeur inférieure à 100 % (1,00), l’ensemble du formulaire, y compris les bordures, est rendu plus transparent. Le fait de définir cette propriété sur une valeur de 0 pour cent (0,00) rend le formulaire complètement invisible. Vous pouvez utiliser cette propriété pour fournir différents niveaux de transparence ou pour fournir des effets tels que l’introduction ou l’affichage progressif d’un formulaire. Par exemple, vous pouvez transformer un formulaire en vue en définissant la Opacity propriété sur une valeur de 0 pour cent (0,00) et en augmentant progressivement la valeur jusqu’à atteindre 100 pour cent (1,00).

Opacity diffère de la transparence fournie par TransparencyKey, ce qui rend un formulaire et ses contrôles complètement transparents uniquement s’ils sont de la même couleur que la valeur spécifiée dans la TransparencyKey propriété.

Cette propriété n’est pas prise en charge quand RightToLeftLayout est true.

La Opacity propriété dépend de l’API Windows en couches. Pour plus d’informations, consultez Windows en couches.

Voir aussi

• TransparencyKey
• LayeredWindows