Form.Opacity Egenskap

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

Egenskapsvärde

Opacitetsnivån för formuläret. Standardvärdet är 1,00.

Attribut

TypeConverterAttribute

Exempel

I följande exempel visas hur du skapar ett formulär som visas med en opacitetsnivå på 75 procent. Det skapar ett nytt formulär som är placerat i mitten av skärmen med en Opacity egenskap inställd på att ändra formulärets ogenomskinlighetsnivå. Exemplet anger också egenskapen så att den Size ger ett större formulär än standardstorleken för formuläret.

Det här exemplet förutsätter att CreateMyOpaqueForm metoden anropas från ett annat formulär i en händelsehanterare eller annan metod.

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

Kommentarer

Med Opacity egenskapen kan du ange en transparensnivå för formuläret och dess kontroller. När den här egenskapen är inställd på ett värde som är mindre än 100 procent (1,00) blir hela formuläret, inklusive kantlinjer, mer transparent. Om du anger den här egenskapen till ett värde på 0 procent (0,00) blir formuläret helt osynligt. Du kan använda den här egenskapen för att ge olika nivåer av transparens eller för att ge effekter som att fasa ut ett formulär i eller ur vyn. Du kan till exempel fasa in ett formulär i vyn genom att ange Opacity egenskapen till ett värde på 0 procent (0,00) och gradvis öka värdet tills det når 100 procent (1,00).

Opacity skiljer sig från transparensen i TransparencyKey, som bara gör ett formulär och dess kontroller helt transparenta om de har samma färg som värdet som anges i TransparencyKey egenskapen.

Den här egenskapen stöds inte när RightToLeftLayout är true.

Egenskapen Opacity beror på API:et Layered Windows. Mer information finns i Layered Windows.

Se även

• TransparencyKey
• LayeredWindows