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

プロパティ値

フォームの右上隅にコントロールボックスを表示する場合は 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 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.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. この問題を解決するには、HandleCreated イベントハンドラーの Location プロパティを変更するコードを記述します。To fix this problem, put the code that alters the Location property in the HandleCreated event handler.

注意

falseに設定した場合、ControlBox プロパティは、作成時に最大化されるマルチドキュメントインターフェイス (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.

適用対象

こちらもご覧ください