Form.Opacity Form.Opacity Form.Opacity Form.Opacity Property

Определение

Возвращает или задает уровень непрозрачности формы.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

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

Уровень непрозрачности для формы.The level of opacity for the form. Значение по умолчанию — 1,00.The default is 1.00.

Примеры

В следующем примере кода показано, как создать форму, которая отображается с степень непрозрачности 75 процентов.The following code example demonstrates how to create a form that is displayed with an opacity level of 75 percent. В примере кода создается новая форма, которая располагается по центру экрана с Opacity задать свойство, чтобы изменить уровень непрозрачности формы.The code example 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. В примере кода также задает Size свойства для предоставления большего размера формы, чем размер по умолчанию формы.The code example also sets the Size property to provide a larger sized form than the default size of the form. Данный пример кода было написано в предположении, что метод, определенный в этом примере вызывается из другой формы в обработчик событий или другой метод.This code example was written under the assumption that the method defined in this example 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

Комментарии

Opacity Свойство позволяет указать уровень прозрачности для формы и ее элементов управления.The Opacity property enables you to specify a level of transparency for the form and its controls. Если этому свойству присвоено значение меньше 100% (1,00), всю форму, включая границы, становится более прозрачной.When this property is set to a value less than 100 percent (1.00), the entire form, including borders, is made more transparent. Этому свойству присвоить значение 0% (0,00), форма становится полностью невидимым.Setting this property to a value of 0 percent (0.00) makes the form completely invisible. Это свойство можно использовать для предоставления различных уровней прозрачности или для предоставления эффектов, например переводить формы в или из представления.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. Например, этап формы в представление, задав Opacity свойства со значением 0% (0,00) и постепенного увеличения данного значения, пока не достигнет значения 100% (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 отличается от прозрачности, предоставленной TransparencyKey, который делает формы и ее элементов управления абсолютно прозрачно в том случае, если это тот же цвет, что значение, указанное в TransparencyKey свойство.Opacity differs from the transparency provided by the 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.

Это свойство не поддерживается при RightToLeftLayout является true.This property is not supported when RightToLeftLayout is true.

Opacity Свойство зависит от многоуровневых Windows API, который был введен в Windows 2000.The Opacity property depends on the Layered Windows API that was introduced with Windows 2000. Дополнительные сведения см. в разделе «многоуровневые Windows: Создать способ использования полупрозрачность и эффектов прозрачности в приложениях Windows» в документации Platform SDK в http://msdn.microsoft.com .For more information, see the "Layered Windows: A New Way to Use Translucency and Transparency Effects in Windows Applications" in the Platform SDK documentation at http://msdn.microsoft.com.

Применяется к

Дополнительно