Form.ControlBox プロパティ

定義

フォームのキャプション バーにコントロール ボックスを表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether a control box is displayed in the caption bar of the form.

public:
 property bool ControlBox { bool get(); void set(bool value); };
public bool ControlBox { get; set; }
member this.ControlBox : bool with get, set
Public Property ControlBox As Boolean

プロパティ値

Boolean

true フォームの右上隅にコントロールボックスを表示する場合は。それ以外の場合は falsetrue if the form displays a control box in the upper-right corner of the form; otherwise, false. 既定では、 trueです。The default is true.

次の例では、、、、、およびの各プロパティを使用して、 ControlBox FormBorderStyle MaximizeBox MinimizeBox StartPosition 境界線またはキャプションボックスのないフォームを作成します。The following example uses the ControlBox, FormBorderStyle, MaximizeBox, MinimizeBox, and StartPosition properties to create a form that does not have any border or caption box. この例で作成したフォームは、アプリケーションのスプラッシュスクリーンを作成するために使用できます。The form created in this example could be used to create a splash screen for an application. この例では、この例のメソッドがフォームクラスで定義され、フォームが初期化されるときに呼び出される必要があります。The example requires that the example's method is defined in a form class and called when the form is being initialized.

public:
   void CreateMyBorderlessWindow()
   {
      this->FormBorderStyle = ::FormBorderStyle::None;
      this->MaximizeBox = false;
      this->MinimizeBox = false;
      this->StartPosition = FormStartPosition::CenterScreen;
      // Remove the control box so the form will only display client area.
      this->ControlBox = false;
   }
public void CreateMyBorderlessWindow()
 {
    this.FormBorderStyle = FormBorderStyle.None;
    this.MaximizeBox = false;
    this.MinimizeBox = false;
    this.StartPosition = FormStartPosition.CenterScreen;
    // Remove the control box so the form will only display client area.
    this.ControlBox = false;
 }
 
Public Sub CreateMyBorderlesWindow()
    FormBorderStyle = FormBorderStyle.None
    MaximizeBox = False
    MinimizeBox = False
    StartPosition = FormStartPosition.CenterScreen
    ' Remove the control box so the form will only display client area.
    ControlBox = False
End Sub

注釈

プロパティがに設定されている場合は、 ControlBox true キャプションバーの右上隅にコントロールボックスが表示されます。If the ControlBox property is set to true, the control box is displayed in the upper-right corner of the caption bar. コントロールボックスには、[閉じる] ボタンに加えて、[最小化]、[最大化]、[ヘルプ] の各ボタンを含めることができます。The control box can include minimize, maximize, and help buttons in addition to a close button. プロパティが何らかの効果を持つようにするには、 ControlBox フォームのプロパティを、、、またはに設定する必要もあり FormBorderStyle FormBorderStyle.FixedSingle FormBorderStyle.Sizable FormBorderStyle.Fixed3D FormBorderStyle.FixedDialog ます。For the ControlBox property to have any effect, you must also set the form's FormBorderStyle property to FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3D, or FormBorderStyle.FixedDialog.

ControlBoxをに設定し、プロパティも設定した場合、フォームの false Location Size 非クライアント領域が非表示になっていることを示すためにフォームのプロパティは更新されません。If you set ControlBox to false and also set the Location property, the Size property of the form is not updated to reflect that the non-client area of the form has been hidden. この問題を解決するには、イベントハンドラーのプロパティを変更するコードを記述し Location HandleCreated ます。To fix this problem, put the code that alters the Location property in the HandleCreated event handler.

注意

に設定すると falseControlBox プロパティは、作成時に最大化されるマルチドキュメントインターフェイス (MDI) 子フォームには影響しません。When set to false, the ControlBox property has no effect on a Multiple-document interface (MDI) child form that is displayed maximized at time of creation.

適用対象

こちらもご覧ください