Form.Opacity Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

Form.cs

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 affiché avec un niveau d’opacité de 75 %. Il crée un formulaire 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’intégralité du formulaire, y compris les bordures, est rendue plus transparente. La définition de cette propriété sur une valeur de 0 % (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 la phase progressive d’un formulaire ou hors vue. Par exemple, vous pouvez phaser un formulaire en mode affichage en définissant la Opacity propriété sur une valeur de 0 % (0,00) et en augmentant progressivement la valeur jusqu’à ce qu’elle atteigne 100 % (1,00).

Opacity diffère de la transparence fournie par TransparencyKey, qui rend uniquement un formulaire et ses contrôles complètement transparents 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