Form.HelpButton プロパティ

定義

フォームのキャプション ボックスに [ヘルプ] ボタンを表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether a Help button should be displayed in the caption box of the form.

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

プロパティ値

Boolean

フォームのキャプション バーにヘルプ ボタンを表示する場合は true。それ以外の場合は falsetrue to display a Help button in the form's caption bar; otherwise, false. 既定では、 falseです。The default is false.

次の例では、の新しいインスタンスを作成 Form し、メソッドを呼び出し ShowDialog てフォームをダイアログボックスとして表示します。The following example creates a new instance of a Form and calls the ShowDialog method to display the form as a dialog box. この例では、、、、、、およびの各プロパティを設定して、 FormBorderStyle AcceptButton CancelButton MinimizeBox MaximizeBox StartPosition フォームの外観と機能をダイアログボックスに変更します。The example sets the FormBorderStyle, AcceptButton, CancelButton, MinimizeBox, MaximizeBox, and StartPosition properties to change the appearance and functionality of the form to a dialog box. また、この例では、 Add フォームのコレクションのメソッドを使用して、 Controls 2 つのコントロールを追加 Button します。The example also uses the Add method of the form's Controls collection to add two Button controls. この例では、プロパティを使用して、 HelpButton ダイアログボックスのキャプションバーに [ヘルプ] ボタンを表示します。The example uses the HelpButton property to display a Help button in the caption bar of the dialog box.

public:
   void CreateMyForm()
   {
      // Create a new instance of the form.
      Form^ form1 = gcnew Form;
      // Create two buttons to use as the accept and cancel buttons.
      Button^ button1 = gcnew Button;
      Button^ button2 = gcnew Button;
      
      // Set the text of button1 to "OK".
      button1->Text = "OK";
      // Set the position of the button on the form.
      button1->Location = Point(10,10);
      // Set the text of button2 to "Cancel".
      button2->Text = "Cancel";
      // Set the position of the button based on the location of button1.
      button2->Location =
         Point( button1->Left, button1->Height + button1->Top + 10 );
      // Set the caption bar text of the form.   
      form1->Text = "My Dialog Box";
      // Display a help button on the form.
      form1->HelpButton = true;
      
      // Define the border style of the form to a dialog box.
      form1->FormBorderStyle = ::FormBorderStyle::FixedDialog;
      // Set the MaximizeBox to false to remove the maximize box.
      form1->MaximizeBox = false;      
      // Set the MinimizeBox to false to remove the minimize box.
      form1->MinimizeBox = false;
      // Set the accept button of the form to button1.
      form1->AcceptButton = button1;
      // Set the cancel button of the form to button2.
      form1->CancelButton = button2;
      // Set the start position of the form to the center of the screen.
      form1->StartPosition = FormStartPosition::CenterScreen;
      
      // Add button1 to the form.
      form1->Controls->Add( button1 );
      // Add button2 to the form.
      form1->Controls->Add( button2 );
      // Display the form as a modal dialog box.
      form1->ShowDialog();
   }
public void CreateMyForm()
{
   // Create a new instance of the form.
   Form form1 = new Form();
   // Create two buttons to use as the accept and cancel buttons.
   Button button1 = new Button ();
   Button button2 = new Button ();
  
   // Set the text of button1 to "OK".
   button1.Text = "OK";
   // Set the position of the button on the form.
   button1.Location = new Point (10, 10);
   // Set the text of button2 to "Cancel".
   button2.Text = "Cancel";
   // Set the position of the button based on the location of button1.
   button2.Location
      = new Point (button1.Left, button1.Height + button1.Top + 10);
   // Set the caption bar text of the form.   
   form1.Text = "My Dialog Box";
   // Display a help button on the form.
   form1.HelpButton = true;

   // Define the border style of the form to a dialog box.
   form1.FormBorderStyle = FormBorderStyle.FixedDialog;
   // Set the MaximizeBox to false to remove the maximize box.
   form1.MaximizeBox = false;
   // Set the MinimizeBox to false to remove the minimize box.
   form1.MinimizeBox = false;
   // Set the accept button of the form to button1.
   form1.AcceptButton = button1;
   // Set the cancel button of the form to button2.
   form1.CancelButton = button2;
   // Set the start position of the form to the center of the screen.
   form1.StartPosition = FormStartPosition.CenterScreen;
   
   // Add button1 to the form.
   form1.Controls.Add(button1);
   // Add button2 to the form.
   form1.Controls.Add(button2);
   
   // Display the form as a modal dialog box.
   form1.ShowDialog();
}
Public Sub CreateMyForm()
    ' Create a new instance of the form.
    Dim form1 As New Form()
    ' Create two buttons to use as the accept and cancel buttons.
    Dim button1 As New Button()
    Dim button2 As New Button()
       
    ' Set the text of button1 to "OK".
    button1.Text = "OK"
    ' Set the position of the button on the form.
    button1.Location = New Point(10, 10)
    ' Set the text of button2 to "Cancel".
    button2.Text = "Cancel"
    ' Set the position of the button based on the location of button1.
    button2.Location = _
       New Point(button1.Left, button1.Height + button1.Top + 10)
    ' Set the caption bar text of the form.   
    form1.Text = "My Dialog Box"
    ' Display a help button on the form.
    form1.HelpButton = True
       
    ' Define the border style of the form to a dialog box.
    form1.FormBorderStyle = FormBorderStyle.FixedDialog
    ' Set the MaximizeBox to false to remove the maximize box.
    form1.MaximizeBox = False
    ' Set the MinimizeBox to false to remove the minimize box.
    form1.MinimizeBox = False
    ' Set the accept button of the form to button1.
    form1.AcceptButton = button1
    ' Set the cancel button of the form to button2.
    form1.CancelButton = button2
    ' Set the start position of the form to the center of the screen.
    form1.StartPosition = FormStartPosition.CenterScreen
       
    ' Add button1 to the form.
    form1.Controls.Add(button1)
    ' Add button2 to the form.
    form1.Controls.Add(button2)
       
    ' Display the form as a modal dialog box.
    form1.ShowDialog()
End Sub

注釈

このプロパティがに設定されている場合は、[ true 閉じる ] ボタンの左側にあるキャプションバーに疑問符の付いた小さいボタンが表示されます。When this property is set to true, a small button with a question mark appears in the caption bar to the left of the Close button. このボタンを使用すると、アプリケーションのヘルプを表示できます。You can use this button to display help for your application. HelpRequestedフォームの [ヘルプ] ボタンがクリックされたときに、ユーザーにヘルプ情報を表示するイベントのイベントハンドラーを作成できます。You can create an event handler for the HelpRequested event to display Help information to the user when the Help button of the form is clicked.

[ヘルプ] ボタンを表示するには、フォームのプロパティの値が ControlBox 、既定値である必要があり true ます。To display a Help button, the value of the form's ControlBox property must be true, its default value. プロパティは、 ControlBox キャプションバーの右上隅に、最大化ボタン、最小化ボタン、ヘルプボタン、および閉じるボタンなどのコントロールが含まれているかどうかを判断します。The ControlBox property determines whether the upper-right corner of the caption bar contains controls such as a maximize button, a minimize button, a help button, and a close button. さらに、フォームのプロパティを、、、またはに設定する必要もあり FormBorderStyle FormBorderStyle.FixedSingle FormBorderStyle.Sizable FormBorderStyle.Fixed3D FormBorderStyle.FixedDialog ます。In addition, you must also set the form's FormBorderStyle property to FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3D, or FormBorderStyle.FixedDialog.

重要

[ HelpButton 最大化 ] ボタンまたは [ 最小化 ] ボタンが表示されている場合、プロパティの値は無視されます。The value of the HelpButton property is ignored if the Maximize or Minimize buttons are shown.

適用対象

こちらもご覧ください