Form.Opacity Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает уровень непрозрачности формы.

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

Значение свойства

Double

Уровень непрозрачности для формы. Значение по умолчанию — 1,00.

Атрибуты

TypeConverterAttribute

Примеры

В следующем примере показано, как создать форму, отображаемую с уровнем непрозрачности 75 процентов. Он создает новую форму, расположенную в центре экрана со свойством Opacity , установленным для изменения уровня непрозрачности формы. В примере также задается Size свойство для предоставления формы большего размера, чем размер формы по умолчанию.

В этом примере предполагается, что CreateMyOpaqueForm метод вызывается из другой формы в обработчике событий или другом методе.

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

Комментарии

Свойство Opacity позволяет указать уровень прозрачности для формы и ее элементов управления. Если для этого свойства задано значение менее 100 процентов (1,00), вся форма, включая границы, становится более прозрачной. Если для этого свойства задано значение 0 % (0,00), форма невидима. Это свойство можно использовать для предоставления различных уровней прозрачности или для предоставления эффектов, таких как поэтапное отображение формы или вне представления. Например, можно фазировать форму в представлении, установив Opacity для свойства значение 0 % (0,00) и постепенно увеличивая значение, пока не достигнет 100 процентов (1,00).

Opacity отличается от прозрачности, предоставляемой TransparencyKey, что делает форму и ее элементы управления полностью прозрачными, если они совпадают с цветом, указанным в свойстве TransparencyKey .

Это свойство не поддерживается в том trueслучаеRightToLeftLayout.

Свойство Opacity зависит от МНОГОуровневого API Windows. Дополнительные сведения см. в статье "Многоуровневые окна".

См. также раздел

• TransparencyKey
• LayeredWindows