Form.Opacity Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der Deckkraftebene des Formulars.
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, setPublic Property Opacity As DoubleEigenschaftswert
Die Deckkraftebene für das Formular. Der Standardwert ist 1.00.
- Attribute
Beispiele
Im folgenden Beispiel wird das Erstellen eines Formulars veranschaulicht, 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 außerdem festgelegt, dass die Size Eigenschaft ein größeres Formular als die Standardgröße des Formulars bereitstellt.
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 der Opacity Eigenschaft können Sie eine Transparenzstufe für das Formular und dessen 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 wie das Aus- oder Auslaufen eines Formulars bereitzustellen. Sie können z. B. ein Formular in die Ansicht einteilen, 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 Transparenz, die von TransparencyKey, die nur ein Formular und seine Steuerelemente vollständig transparent macht, wenn sie die gleiche Farbe wie der in der TransparencyKey Eigenschaft angegebene Wert sind.
Diese Eigenschaft wird in diesem Fall RightToLeftLayouttruenicht unterstützt.
Die Opacity Eigenschaft hängt von der Mehrschicht-Windows-API ab. Weitere Informationen finden Sie unter Layered Windows.
