Form.Opacity プロパティ

定義

フォームの不透明度を取得または設定します。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 example demonstrates how to create a form that is displayed with an opacity level of 75 percent. フォームの不透明度を変更するために Opacity プロパティが設定された、画面の中央に配置される新しいフォームを作成します。It 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 example also sets the Size property to provide a larger sized form than the default size of the form.

この例では、CreateMyOpaqueForm メソッドがイベントハンドラーまたは他のメソッドの別の形式から呼び出されていることを前提としています。This example assumes that the CreateMyOpaqueForm method 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 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.

RightToLeftLayouttrue場合、このプロパティはサポートされません。This property is not supported when RightToLeftLayout is true.

Opacity プロパティは、レイヤード Windows API に依存します。The Opacity property depends on the Layered Windows API. 詳細については、「レイヤードウィンドウ」を参照してください。For more information, see Layered Windows.

適用対象

こちらもご覧ください