Show Sitemap ..Help2HTMLHelpWinHelp

Pop-up Hilfe für Visual Basic .NET Steuerelemente erstellen

Windows Forms unterstützt "What's this .." Hilfe für einzelne Steuerelemente (Pop-up Hilfe). Der Hilfebutton ist bei Dialogboxen sinnvoll, weil modal angezeigte Dialogfenster geschlossen werden müssen, bevor ein anderes Fenster den Fokus erhalten kann.

Dieser Hilfebutton befindet sich auf der rechten Seite der Titelzeile und auf ihn kann durch die HelpButton Eigenschaften zugegriffen werden. Damit der Hilfebutton auf Ihrem Formular angezeigt wird, ist es erforderlich die MinimizeBox und MaximizeBox Eigenschaft des Formulars auf "False" und die HelpButton Eigenschaft auf "True" zu setzen.

Um Pop-up Hilfe in Ihrer Anwendung zu unterstützen, müssen Sie die HelpProvider Komponente aus der Toolbox der Windows Forms Registerkarte verwenden. Ziehen Sie eine HelpProvider Komponente aus der Toolbox auf Ihr Formular. Es ist eine Komponente statt einem Steuerelement, so dass es nach dem Ziehen auf Ihr Formular unten im Komponentenrahmen sitzt. Benennen Sie diese Komponente in "hlpProvider1" um. Diese Komponente gibt jedem Steuerelement auf der Form drei neue Eigenschaften, die HelpKeyword, HelpNavigator und HelpString auf hlpProvider1 heißen.

Beim nächsten Schritt tragen Sie in die HelpString auf hlpProvider1 Eigenschaft den anzuzeigenden Text ein. Sie können dieses auch durch Schreiben von Code tun.

Visual Basic Code

nach InitializeComponent():

Public Class frmMain
  Inherits System.Windows.Forms.Form

#Region " Vom Windows Form Designer generierter Code "

  Public Sub New()
    MyBase.New()

    '--- Dieser Aufruf ist für den Windows Form-Designer erforderlich.
    InitializeComponent()

    '--- Initialisierungen nach dem Aufruf InitializeComponent() hinzufügen
    Me.hlpProvider1.SetHelpString(Me.txtPopUp, "This is the text field. Enter some text.")
  End Sub

Sichern Sie den Text als neuen HelpString für dieses Steuerelement durch Setzen der Eigenschaft SetHelpString.

  Private Sub cmdSave_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles cmdSave.Click
    Me.hlpProvider1.SetHelpString(Me.txtPopUp, Me.txtPopUp.Text)
  End Sub

Inaktivieren Sie die Pop-Up Nachricht für dieses Steuerelement durch setzen der Eigenschaft SetShowHelp auf "False".

  Private Sub cmdSave_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles cmdSave.Click
    Me.hlpProvider1.SetShowHelp(Me.txtPopUp, False)
  End Sub

Note:

Die Windows Forms HelpProvider Komponente wird verwendet, um HTMLHelp Dateien (HTMLHelp 1.x, Help 2.x oder einzelne HTML Dateien) mit Ihrer Windows Anwendung zu verbinden,. Die HelpString Eigenschaft kann verwendet werden, um Pop-Up Hilfe anzuzeigen aber Sie müssen dazu die HelpNamespace Eigenschaft von hlpProvider1 setzen (siehe HTMLHelp). Wenn es keinen Dateinamen gibt und der Benutzer F1 drückt, läuft die Anwendung auf einem Fehler.

 

Download Beispiel

Wenn Sie kein Visual Studio NET besitzen aber das Microsoft NET Framework 1.0 installiert haben (z.B. von der CD-Version des Windows XP SP1) können Sie das Beispiel für Visual Basic 2002 entpacken und die Datei VBnetCHM.exe im Unterverzeichnis "../bin" doppelklicken.

 

Top ...