Udostępnij za pośrednictwem

Porady: zapewnianie pomocy w aplikacji Windows

  • Artykuł

Możesz użyć HelpProvider składnika, aby dołączyć tematy Pomocy w pliku Pomocy do określonych kontrolek w formularzach systemu Windows. Plik Pomocy może mieć format HTML lub HTMLHelp 1.x lub nowszy.

Zapewnianie pomocy

  1. W programie Visual Studio z przybornika przeciągnij HelpProvider składnik do formularza.

    Składnik będzie znajdować się w zasobniku w dolnej części Projektant Windows Forms.

  2. W oknie Właściwości ustaw HelpNamespace właściwość na plik pomocy .chm, col lub .htm.

  3. Wybierz inną kontrolkę, którą masz w formularzu, a w oknie Właściwości ustaw SetHelpKeyword właściwość .

    Jest to ciąg przekazywany przez HelpProvider składnik do pliku Pomocy w celu wywołania odpowiedniego tematu Pomocy.

  4. W oknie Właściwości ustaw SetHelpNavigator właściwość na wartość HelpNavigator wyliczenia.

    Określa sposób, w jaki właściwość HelpKeyword jest przekazywana do systemu Pomocy. W poniższej tabeli przedstawiono możliwe ustawienia i ich opisy.

    Nazwa elementu członkowskiego opis
    AssociateIndex Określa, że indeks określonego tematu jest wykonywany w określonym adresie URL.
    Znajdź Określa, że zostanie wyświetlona strona wyszukiwania określonego adresu URL.
    Indeks Określa, że indeks określonego adresu URL jest wyświetlany.
    Indeks słów kluczowych Określa słowo kluczowe do wyszukania i akcję do wykonania w określonym adresie URL.
    TableOfContents Określa, że zostanie wyświetlony spis treści pliku Pomocy HTML 1.0.
    Temat Określa, że zostanie wyświetlony temat, do którego odwołuje się określony adres URL.

W czasie wykonywania naciśnięcie klawisza F1, gdy kontrolka — dla której ustawiono właściwości HelpKeyword i HelpNavigator — spowoduje otwarcie pliku Pomocy skojarzonego z tym HelpProvider składnikiem.

Obecnie właściwość HelpNamespace obsługuje pliki Pomocy w następujących trzech formatach: HTMLHelp 1.x, HTMLHelp 2.0 i HTML. W związku z tym można ustawić właściwość HelpNamespace na http:// adres, taki jak strona sieci Web. W takim przypadku zostanie otwarta domyślna przeglądarka na stronie sieci Web z ciągiem określonym we właściwości HelpKeyword używanym jako kotwica. Kotwica służy do przechodzenia do określonej części strony HTML.

Ważne

Należy zachować ostrożność, aby sprawdzić wszelkie informacje wysyłane z klienta przed użyciem go w aplikacji. Złośliwi użytkownicy mogą próbować wysyłać lub wprowadzać skrypt wykonywalny, instrukcje SQL lub inny kod. Przed wyświetleniem danych wejściowych użytkownika, zapisz je w bazie danych lub współpracuj z nią, sprawdź, czy nie zawiera potencjalnie niebezpiecznych informacji. Typowym sposobem sprawdzania jest użycie wyrażenia regularnego w celu wyszukania słów kluczowych, takich jak "SCRIPT" podczas odbierania danych wejściowych od użytkownika.

Możesz również użyć HelpProvider składnika do wyświetlania wyskakujących okienek Pomocy, nawet jeśli skonfigurowano wyświetlanie plików Pomocy dla kontrolek w formularzach systemu Windows. Aby uzyskać więcej informacji, zobacz How to: Display Pop-up Help (Instrukcje: wyświetlanie pomocy podręcznej).

Zobacz też