Form.Opacity Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia poziom nieprzezroczystości formularza.

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

Wartość właściwości

Double

Poziom nieprzezroczystości formularza. Wartość domyślna to 1.00.

Atrybuty
TypeConverterAttribute

Przykłady

W poniższym przykładzie pokazano, jak utworzyć formularz, który jest wyświetlany z poziomem nieprzezroczystości 75 procent. Tworzy nowy formularz umieszczony w środku ekranu z właściwością ustawioną Opacity na zmianę poziomu nieprzezroczystości formularza. W przykładzie ustawiono Size również właściwość w celu udostępnienia formularza o większym rozmiarze niż domyślny rozmiar formularza.

W tym przykładzie przyjęto założenie, że CreateMyOpaqueForm metoda jest wywoływana z innego formularza w procedurze obsługi zdarzeń lub innej metodzie.

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

Uwagi

Właściwość Opacity umożliwia określenie poziomu przezroczystości formularza i jego kontrolek. Gdy ta właściwość jest ustawiona na wartość mniejszą niż 100 procent (1,00), cały formularz, w tym obramowania, jest bardziej przejrzysty. Ustawienie tej właściwości na wartość 0 procent (0,00) sprawia, że formularz jest całkowicie niewidoczny. Możesz użyć tej właściwości, aby zapewnić różne poziomy przezroczystości lub zapewnić efekty, takie jak wycofywanie formularza w widoku lub poza niego. Na przykład można przekształcić formularz w widok, ustawiając Opacity właściwość na wartość 0 procent (0,00) i stopniowo zwiększając wartość do momentu osiągnięcia 100 procent (1,00).

Opacity różni się od przezroczystości zapewnianej przez TransparencyKeyelement , co sprawia, że formularz i jego kontrolki są całkowicie przezroczyste, jeśli są one tym samym kolorem co wartość określona TransparencyKey we właściwości.

Ta właściwość nie jest obsługiwana, gdy RightToLeftLayout ma wartość true.

Właściwość Opacity zależy od warstwowego interfejsu API systemu Windows. Aby uzyskać więcej informacji, zobacz Warstwowe okna.

Dotyczy

Zobacz też