Form.ControlBox Form.ControlBox Form.ControlBox Form.ControlBox Property


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

 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


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

次のコード例では、 ControlBoxFormBorderStyleMaximizeBoxMinimizeBox、およびStartPositionプロパティが、境界線またはキャプション ボックス フォームを作成します。The following code 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.

   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 'CreateMyBorderlesWindow


場合、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.FixedSingleFormBorderStyle.SizableFormBorderStyle.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.

設定した場合ControlBoxfalseも設定して、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.