Form.HelpButton 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

Form.cs

取得或設定值，指出是否應在表單的標題方塊中顯示 [說明] 按鈕。

C#

public bool HelpButton { get; set; }

屬性值

Boolean

若要在表單的標題列中顯示 [說明] 按鈕，則為 true，否則為 false。 預設為 false。

範例

下列範例會建立 的新 實例 Form ，並呼叫 ShowDialog 方法，將表單顯示為對話方塊。 此範例會將 FormBorderStyle 、 AcceptButton 、 CancelButton 、 MinimizeBox 、 MaximizeBox 和 StartPosition 屬性設定為將表單的外觀和功能變更為對話方塊。 此範例也會使用 Add 表單集合的 Controls 方法來加入兩 Button 個控制項。 此範例會 HelpButton 使用 屬性，在對話方塊的標題列中顯示 [說明] 按鈕。

C#

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();
}

備註

當此屬性設定為 true 時，具有問號的小按鈕會出現在 [關閉] 按鈕左邊的標題列中。 您可以使用此按鈕來顯示應用程式的說明。 您可以為事件建立事件處理常式， HelpRequested 以在按一下表單的 [說明] 按鈕時向使用者顯示 [說明] 資訊。

若要顯示 [說明] 按鈕，表單的 ControlBox 屬性值必須是 true ，其預設值。 屬性 ControlBox 會決定標題列的右上角是否包含最大化按鈕、最小化按鈕、說明按鈕和關閉按鈕等控制項。 此外，您也必須將表單的 FormBorderStyle 屬性設定為 FormBorderStyle.FixedSingle 、 FormBorderStyle.Sizable 、 FormBorderStyle.Fixed3D 或 FormBorderStyle.FixedDialog 。

重要

如果顯示[最大化] 或 [最小化] 按鈕，則會忽略 屬性的值 HelpButton 。

適用於

另請參閱

• MinimizeBox
• MaximizeBox
• ControlBox
• HelpButtonClicked