Form.ControlBox プロパティ

定義

フォームのキャプション バーにコントロール ボックスを表示するかどうかを示す値を取得または設定します。

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 です。

次の例では、、FormBorderStyleMaximizeBoxMinimizeBoxおよび StartPosition プロパティをControlBox使用して、罫線やキャプション ボックスのないフォームを作成します。 この例で作成したフォームを使用して、アプリケーションのスプラッシュ スクリーンを作成できます。 この例では、この例の メソッドがフォーム クラスで定義され、フォームが初期化されるときに呼び出される必要があります。

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

注釈

プロパティが ControlBoxtrue設定されている場合、コントロール ボックスはキャプション バーの右上隅に表示されます。 コントロール ボックスには、閉じるボタンに加えて、最小化ボタン、最大化ボタン、ヘルプ ボタンを含めることができます。 プロパティをControlBox有効にするには、フォームの FormBorderStyle プロパティを 、、FormBorderStyle.SizableFormBorderStyle.Fixed3D、または FormBorderStyle.FixedDialogに設定するFormBorderStyle.FixedSingle必要もあります。

を に設定ControlBoxし、 プロパティも設定Locationした場合、Sizeフォームのクライアント以外の領域が非表示になっていることを反映するように、フォームの プロパティは更新falseされません。 この問題を解決するには、プロパティを変更するコードを Location イベント ハンドラーに HandleCreated 配置します。

注意

false設定すると、 ControlBox プロパティは、作成時に最大化されて表示される複数ドキュメント インターフェイス (MDI) の子フォームには影響しません。

適用対象

こちらもご覧ください