Proprietà Form.Opacity

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)

Valore proprietà

La proprietà Opacity consente di specificare il livello di trasparenza del form e dei relativi controlli. Quando il valore impostato per questa proprietà è inferiore a 100 percento (1,00), verrà reso più trasparente l'intero form, inclusi i bordi. Se si imposta un valore pari a 0 percento (0,00) il form risulterà completamente invisibile. Questa proprietà consente di ottenere diversi livelli di trasparenza oppure di visualizzare e nascondere gradualmente un form. È possibile, ad esempio, visualizzare gradualmente un form impostando la proprietà Opacity sul valore 0 percento (0,00), quindi aumentando gradualmente tale valore fino a raggiungere il valore 100 percento (1,00).

La proprietà Opacity è diversa dalla trasparenza fornita dalla proprietà TransparencyKey, che rende un form e i relativi controlli completamente trasparenti solo se il colore coincide con il valore specificato nella proprietà TransparencyKey.

Questa proprietà non è supportata quando RightToLeftLayout è true.

La proprietà Opacity dipende dall'interfaccia API per finestre sovrapposte introdotta in Windows 2000. Per ulteriori informazioni, vedere "Layered Windows: A New Way to Use Translucency and Transparency Effects in Windows Applications" nella documentazione relativa a Platform SDK http://www.microsoft.com/italy/msdn.

Nota sulla piattaforma Windows 2000, Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003: Supporta l'interfaccia API per finestre sovrapposte. Questa proprietà non ha effetto sulle piattaforme che non consentono la visualizzazione di finestre sovrapposte. Alcuni driver video, inoltre, non supportano la visualizzazione a livelli.

Nell'esempio di codice riportato di seguito viene illustrato come creare un form visualizzato con un livello di opacità del 75%. Nell'esempio viene posizionato un nuovo form al centro dello schermo e viene impostata la proprietà Opacity per modificare il livello di opacità del form. Viene inoltre impostata la proprietà Size per aumentare le dimensioni del form rispetto a quelle predefinite. Nell'esempio si presuppone che il metodo definito venga chiamato da un altro form in un gestore eventi o da un altro metodo.

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 per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework