Form.Opacity Property

Definition

Ruft die Durchlässigkeit des Formulars ab oder legt diese fest.Gets or sets the opacity level of the form.

public:
 property double Opacity { double get(); void set(double value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.OpacityConverter))]
public double Opacity { get; set; }
member this.Opacity : double with get, set
Public Property Opacity As Double

Property Value

Double

Die Durchlässigkeit des Formulars.The level of opacity for the form. Der Standard ist 1,00.The default is 1.00.

Attributes

Examples

Im folgenden Beispiel wird veranschaulicht, wie ein Formular erstellt wird, das mit einem Deckkraft Grad von 75 Prozent angezeigt wird.The following example demonstrates how to create a form that is displayed with an opacity level of 75 percent. Es wird ein neues Formular erstellt, das sich in der Mitte des Bildschirms befindet, wobei eine Opacity-Eigenschaft festgelegt ist, um die Deckkraft des Formulars zu ändern.It creates a new form that is positioned in the center of the screen with an Opacity property set to change the opacity level of the form. Im Beispiel wird auch die Size-Eigenschaft so festgelegt, dass Sie eine größere Größe als die Standardgröße des Formulars bereitstellt.The example also sets the Size property to provide a larger sized form than the default size of the form.

In diesem Beispiel wird davon ausgegangen, dass die CreateMyOpaqueForm-Methode von einem anderen Formular in einem Ereignishandler oder einer anderen Methode aufgerufen wird.This example assumes that the CreateMyOpaqueForm method is called from another form in an event handler or other method.

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

Remarks

Die Opacity-Eigenschaft ermöglicht es Ihnen, eine Ebene der Transparenz für das Formular und seine Steuerelemente anzugeben.The Opacity property enables you to specify a level of transparency for the form and its controls. Wenn diese Eigenschaft auf einen Wert kleiner als 100 Prozent (1,00) festgelegt ist, wird das gesamte Formular, einschließlich der Rahmen, transparenter.When this property is set to a value less than 100 percent (1.00), the entire form, including borders, is made more transparent. Wenn diese Eigenschaft auf einen Wert von 0% (0,00) festgelegt wird, ist das Formular vollständig unsichtbar.Setting this property to a value of 0 percent (0.00) makes the form completely invisible. Sie können diese Eigenschaft verwenden, um unterschiedliche Transparenz Ebenen bereitzustellen oder um Effekte bereitzustellen, wie z. b. das einstufen eines Formulars in oder aus der Ansicht.You can use this property to provide different levels of transparency or to provide effects such as phasing a form in or out of view. Sie können z. b. ein Formular in die Ansicht einstufen, indem Sie die Opacity-Eigenschaft auf einen Wert von 0% (0,00) festlegen und den Wert schrittweise erhöhen, bis er 100% erreicht (1,00).For example, you can phase a form into view by setting the Opacity property to a value of 0 percent (0.00) and gradually increasing the value until it reaches 100 percent (1.00).

Opacity unterscheidet sich von der von TransparencyKeybereitgestellten Transparenz, bei der nur ein Formular und seine Steuerelemente vollständig transparent sind, wenn Sie dieselbe Farbe wie der Wert haben, der in der TransparencyKey-Eigenschaft angegeben ist.Opacity differs from the transparency provided by TransparencyKey, which only makes a form and its controls completely transparent if they are the same color as the value specified in the TransparencyKey property.

Diese Eigenschaft wird nicht unterstützt, wenn RightToLeftLayout trueist.This property is not supported when RightToLeftLayout is true.

Die Opacity-Eigenschaft hängt von der überlagerten Windows-API ab.The Opacity property depends on the Layered Windows API. Weitere Informationen finden Sie unter über lagerte Fenster.For more information, see Layered Windows.

Applies to

See also