Form.Opacity Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

Form.cs

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

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 .

Это свойство не поддерживается при RightToLeftLayout использовании true.

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

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

• TransparencyKey
• LayeredWindows