Form.Opacity-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property Opacity As Double
'Usage
Dim instance As Form
Dim value As Double

value = instance.Opacity

instance.Opacity = value

public double Opacity { get; set; }

public:
property double Opacity {
    double get ();
    void set (double value);
}

/** @property */
public double get_Opacity ()

/** @property */
public void set_Opacity (double value)

public function get Opacity () : double

public function set Opacity (value : double)

Eigenschaftenwert

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

Hinweise

Mit der Opacity-Eigenschaft können Sie den Grad der Transparenz für das Formular und dessen Steuerelemente angeben. Wenn diese Eigenschaft auf einen Wert unter 100 Prozent (1.00) festgelegt wird, wird das gesamte Formular einschließlich des Rahmens stärker transparent angezeigt. Durch Festlegen dieser Eigenschaft auf 0 Prozent (0.00) wird das Formular vollständig unsichtbar. Diese Eigenschaft ermöglicht unterschiedliche Transparenzgrade oder Effekte wie das graduelle Ein- und Ausblenden eines Formulars. Beispielsweise können Sie ein Formular einblenden, indem Sie die Opacity-Eigenschaft auf einen Wert von 0 Prozent (0.00) festlegen und diesen dann schrittweise bis auf 100 Prozent (1.00) erhöhen.

Opacity unterscheidet sich von der durch TransparencyKey bereitgestellten Transparenz, die ein Formular und dessen Steuerelemente nur dann vollständig transparent anzeigt, wenn deren Farbe mit der in der TransparencyKey-Eigenschaft angegebenen Farbe übereinstimmt.

Diese Eigenschaft wird nicht unterstützt, wenn RightToLeftLayouttrue ist.

Die Opacity-Eigenschaft ist abhängig von der Layered Windows-API (API für überlappende Fenster), die mit Windows 2000 eingeführt wurde. Weitere Informationen finden Sie im Thema "Layered Windows: A New Way to Use Translucency and Transparency Effects in Windows Applications" in der Platform SDK-Dokumentation unter https://www.microsoft.com/germany/msdn.

Hinweis zu Windows 2000, Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003: Unterstützt die Layered Windows-API (API für überlappende Fenster). Diese Eigenschaft hat auf Plattformen, die keine überlappenden Fenster darstellen können, keine Auswirkungen. Außerdem unterstützen einige Anzeigetreiber das Überlappen nicht.

Beispiel

Im folgenden Codebeispiel wird das Erstellen eines Formulars veranschaulicht, das mit einer Durchlässigkeit von 75 % angezeigt wird. Im Codebeispiel wird ein neues Formular in der Mitte des Bildschirms erstellt, wobei die Opacity-Eigenschaft so festgelegt ist, dass die Durchlässigkeit des Formulars geändert wird. Im Codebeispiel wird die Size-Eigenschaft zudem so festgelegt, dass sie ein Formular bereitstellt, das größer als die Standardgröße des Formulars ist. In diesem Codebeispiel wird davon ausgegangen, dass die hier definierte Methode aus einem anderen Formular in einem Ereignishandler oder über eine andere Methode aufgerufen wird.

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

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:
   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.set_Text("My Form");

    // Set the opacity to 75%.
    form2.set_Opacity(0.75);

    // Size the form to be 300 pixels in height and width.
    form2.set_Size(new Size(300, 300));

    // Display the form in the center of the screen.
    form2.set_StartPosition(FormStartPosition.CenterScreen);

    // Display the form as a modal dialog box.
    form2.ShowDialog();
} //CreateMyOpaqueForm

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Form-Klasse
Form-Member
System.Windows.Forms-Namespace
TransparencyKey
LayeredWindows

Freigeben über