Form.Opacity Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Durchlässigkeit des Formulars ab oder legt diese fest.

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

Eigenschaftswert

Double

Die Durchlässigkeit des Formulars. Der Standard ist 1,00.

Attribute

TypeConverterAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie ein Formular erstellen, das mit einer Deckkraft von 75 Prozent angezeigt wird. Es erstellt ein neues Formular, das in der Mitte des Bildschirms positioniert ist, wobei eine Opacity Eigenschaft festgelegt ist, um die Deckkraftebene des Formulars zu ändern. Im Beispiel wird auch festgelegt, dass die Size -Eigenschaft ein Formular bereitstellt, das größer als die Standardgröße des Formulars ist.

In diesem Beispiel wird davon ausgegangen, dass die CreateMyOpaqueForm Methode aus einem anderen Formular in einem Ereignishandler oder einer anderen Methode aufgerufen wird.

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

Hinweise

Mit Opacity der -Eigenschaft können Sie eine Transparenzebene für das Formular und seine Steuerelemente angeben. Wenn diese Eigenschaft auf einen Wert unter 100 Prozent (1,00) festgelegt ist, wird das gesamte Formular einschließlich rahmen transparenter gemacht. Wenn Sie diese Eigenschaft auf einen Wert von 0 Prozent (0,00) festlegen, wird das Formular vollständig unsichtbar. Sie können diese Eigenschaft verwenden, um unterschiedliche Transparenzebenen bereitzustellen oder Effekte bereitzustellen, z. B. das Phasieren eines Formulars in oder aus dem Sichtfeld. Sie können beispielsweise ein Formular in die Ansicht stufen, indem Sie die Opacity Eigenschaft auf einen Wert von 0 Prozent (0,00) festlegen und den Wert schrittweise erhöhen, bis er 100 Prozent (1,00) erreicht.

Opacity unterscheidet sich von der von TransparencyKeybereitgestellten Transparenz, die ein Formular und seine Steuerelemente nur vollständig transparent macht, wenn sie dieselbe Farbe wie der in der TransparencyKey -Eigenschaft angegebene Wert aufweisen.

Diese Eigenschaft wird nicht unterstützt, wenn RightToLeftLayout ist true.

Die Opacity -Eigenschaft hängt von der Mehrschicht-Windows-API ab. Weitere Informationen finden Sie unter Mehrschichtige Fenster.

Weitere Informationen

• TransparencyKey
• LayeredWindows