Form.HelpButton Eigenschap

Definitie

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een Help-knop moet worden weergegeven in het bijschriftvak van het formulier.

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

Waarde van eigenschap

true om een Help-knop weer te geven op de bijschriftbalk van het formulier; anders, false. De standaardwaarde is false.

Voorbeelden

In het volgende voorbeeld wordt een nieuw exemplaar van een Form gemaakt en wordt de ShowDialog methode aangeroepen om het formulier weer te geven als een dialoogvenster. In het voorbeeld worden de FormBorderStyleeigenschappen , AcceptButton, , MaximizeBoxCancelButtonMinimizeBoxen StartPosition eigenschappen ingesteld om het uiterlijk en de functionaliteit van het formulier te wijzigen in een dialoogvenster. In het voorbeeld wordt ook de methode van de Add verzameling van het formulier Controls gebruikt om twee Button besturingselementen toe te voegen. In het voorbeeld wordt de HelpButton eigenschap gebruikt om een Help-knop weer te geven op de bijschriftbalk van het dialoogvenster.

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

Opmerkingen

Wanneer deze eigenschap is ingesteld trueop, wordt een kleine knop met een vraagteken weergegeven in de bijschriftbalk links van de knop Sluiten . U kunt deze knop gebruiken om help voor uw toepassing weer te geven. U kunt een gebeurtenis-handler voor de HelpRequested gebeurtenis maken om Help-informatie weer te geven aan de gebruiker wanneer op de knop Help van het formulier wordt geklikt.

Als u een Help-knop wilt weergeven, moet de waarde van de eigenschap van het formulier ControlBox de standaardwaarde zijn true. De ControlBox eigenschap bepaalt of de rechterbovenhoek van de bijschriftbalk besturingselementen bevat, zoals een knop maximaliseren, een geminimaliseerde knop, een Help-knop en een knop Sluiten. Daarnaast moet u ook de eigenschap van FormBorderStyle het formulier instellen op FormBorderStyle.FixedSingle, FormBorderStyle.Sizableof FormBorderStyle.Fixed3DFormBorderStyle.FixedDialog.

Important

De waarde van de HelpButton eigenschap wordt genegeerd als de knoppen Maximaliseren of Minimaliseren worden weergegeven.

Van toepassing op

Zie ook