Exporter (0) Imprimer
Développer tout
Développer Réduire

Form.Opacity, propriété

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

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

public double Opacity { get; set; }
/** @property */
public double get_Opacity ()

/** @property */
public void set_Opacity (double value)

public function get Opacity () : double

public function set Opacity (value : double)

Valeur de la propriété

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

La propriété Opacity vous permet de spécifier le niveau de transparence du formulaire et de ses contrôles. Si cette propriété reçoit une valeur inférieure à 100 pour cent (1,00), le formulaire tout entier, y compris ses bordures, acquiert une certaine transparence. Si vous affectez à cette propriété la valeur 0 pour cent (0,00), le formulaire est complètement invisible. Vous pouvez utiliser cette propriété pour définir différents degrés de transparence ou pour appliquer des effets comme l'affichage ou la disparition progressifs d'un formulaire. Par exemple, il est possible d'afficher progressivement un formulaire en affectant à la propriété Opacity la valeur 0 pour cent (0,00) et en augmentant graduellement cette valeur jusqu'à ce qu'elle atteigne 100 pour cent (1,00).

Opacity diffère de la transparence déterminée par TransparencyKey, qui ne rend un formulaire et ses contrôles entièrement transparents que s'ils sont de la même couleur que la valeur spécifiée dans la propriété TransparencyKey.

Cette propriété n'est pas prise en charge lorsque RightToLeftLayout a la valeur true.

La propriété Opacity dépend de l'API Layered Windows introduit par Windows 2000. Pour plus d'informations, consultez « Layered Windows: A New Way to Use Translucency and Transparency Effects in Windows Applications » dans la documentation du kit de développement Platform SDK à l'adresse http://www.microsoft.com/france/msdn..

Remarque sur la plate-forme Windows 2000, Windows 2000 Professionnel, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Édition Familiale, Windows XP Professionnel Édition x64, Windows Server 2003 : Prend en charge l'API Layered Windows. Cette propriété n'a aucun effet sur les plates-formes incapables d'afficher des fenêtres superposées. De plus, certains pilotes d'affichage ne prennent pas en charge la superposition.

L'exemple de code suivant montre comment créer un formulaire qui s'affiche avec un niveau d'opacité de 75 pour cent. L'exemple de code crée un formulaire placé au centre de l'écran avec une propriété Opacity définie pour modifier le niveau d'opacité du formulaire. L'exemple de code définit également la propriété Size pour fournir un formulaire dont la taille est supérieure à sa taille par défaut. Cet exemple de code suppose que la méthode définie dans ce dernier soit appelée à partir d'un autre formulaire dans un gestionnaire d'événements ou d'une autre méthode.

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 void CreateMyOpaqueForm()
{
    // Create a new form.
    Form form2 = new Form();

    // Set the text displayed in the caption.
    form2.set_Text("My Form");

    // Set the opacity to 75%.
    form2.set_Opacity(0.75);

    // Size the form to be 300 pixels in height and width.
    form2.set_Size(new Size(300, 300));

    // Display the form in the center of the screen.
    form2.set_StartPosition(FormStartPosition.CenterScreen);

    // Display the form as a modal dialog box.
    form2.ShowDialog();
} //CreateMyOpaqueForm

Windows 98, Windows 2000 SP4, Windows CE, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft