TESTHELP-Beispiel: ActiveX-Steuerelement mit QuickInfo und Hilfe

  • Artikel

Aktualisiert: November 2007

Das TESTHELP-Beispiel demonstriert die Verwendung von MFC zum Erstellen eines ActiveX-Steuerelements, das seine eigene Hilfedatei zum Anzeigen der Hilfe für den Benutzer besitzt. Testhelp.ocx zeigt darüber hinaus, wie Sie QuickInfos zu einem MFC-ActiveX-Steuerelement hinzufügen können.

Sicherheitshinweis:

Dieser Beispielcode dient dazu, ein Konzept zu veranschaulichen. Er sollte nicht für Anwendungen oder Websites verwendet werden, da dieser Code unter Umständen nicht die sicherste Codierungstechnik darstellt. Microsoft übernimmt keine Haftung für beiläufig entstandene Schäden oder Folgeschäden, falls der Beispielcode nicht bestimmungsgemäß verwendet wird.

So rufen Sie Beispiele und Anweisungen für ihre Installation ab

  • Klicken Sie in Visual Studio im Menü Hilfe auf Beispiele.

    Weitere Informationen finden Sie unter Suchen von Beispieldateien.

  • Die neueste Version und vollständige Liste mit Beispielen ist online unter Visual Studio 2008 Samples verfügbar.

  • Sie können auch Beispiele auf der Festplatte des Computers suchen. Standardmäßig werden Beispiele und eine Infodatei in einen Ordner unter \Programme\Visual Studio 9.0\Samples\ kopiert. Für Express Editions von Visual Studio sind alle Beispiele online verfügbar.

Erstellen und Ausführen des Beispiels

So erstellen Sie das TESTHELP-Beispiel und führen es aus

  1. Öffnen Sie die Projektmappe Testhelp.sln.

  2. Klicken Sie im Menü Erstellen auf Erstellen.

Nach der Erstellung des TESTHELP-Beispiels können Sie dieses in jeder beliebigen ActiveX-Containeranwendung verwenden. Informationen zum Zugreifen auf den Testcontainer finden Sie unter Testen von Eigenschaften und Ereignissen mit dem Testcontainer. Fügen Sie das TESTHELP-Steuerelement in das Projekt des Containers ein, und führen Sie das Projekt aus. Sie können die Eigenschaften des TESTHELP-Steuerelements durch Öffnen des Eigenschaftendialogfelds des Containers festlegen.

Die Hilfeprojektdatei und alle Quelldateien des Hilfeprojekts befinden sich auch in diesem Beispiel.

So erstellen Sie die TESTHELP-Hilfedatei neu und führen sie aus

  1. Klicken Sie im Startmenü auf Help Workshop.

  2. Öffnen Sie Testhelp.hpj. Help Workshop zeigt einen Assistenten zum Konvertieren der Datei in eine HHP-Datei an. Führen Sie den Assistenten aus, indem Sie der Datei einen Namen geben und die Änderungen übernehmen.

  3. Klicken Sie im Menü Datei auf Kompilieren. Geben Sie im Dialogfeld Create a compiled file an, wo Sie die kompilierte Datei speichern möchten, und klicken Sie anschließend auf Kompilieren.

  4. Klicken Sie zum Anzeigen der kompilierten Datei im Menü Ansicht auf Kompilierte Hilfedateien.

TESTHELP-Features

TESTHELP demonstriert, wie Sie folgende Vorgänge ausführen können:

  • Anzeigen einer QuickInfo für das ActiveX-Steuerelement.

  • Aktivieren und Deaktivieren der QuickInfo mithilfe der Eigenschaftenseite des Steuerelements.

  • Ändern des QuickInfo-Texts mithilfe der Eigenschaftenseite des Steuerelements.

  • Aktivieren der Schaltfläche Hilfe im Eigenschaftenrahmen eines ActiveX-Steuerelementcontainers zum Anzeigen der Hilfedatei des Steuerelements, wenn auf die Schaltfläche Hilfe geklickt wird.

  • Aktivieren der Schaltfläche ? in der Sammlung der Komponenten und Steuerelemente in Visual C++, damit die Hilfedatei des Steuerelements angezeigt wird, wenn dieses Steuerelement aus der Sammlung ausgewählt und auf die Schaltfläche ? geklickt wird.

  • Anzeigen der Hilfe zur Laufzeit, wenn das Steuerelement den Tastaturfokus hat und F1 gedrückt wird.

  • Verwenden der vordefinierten Eigenschaften Font, BackColor und ForeColor eines ActiveX-Steuerelements.

Eigenschaftenseite "Allgemein"

  • Type of Help to Use
    Diese Eigenschaft legt fest, wie die Hilfe verwendet wird, wenn der Benutzer F1 drückt, während das TESTHELP-Steuerelement den Tastaturfokus hat. Hilfe in einem Popupfenster bedeutet, dass ein Popupfenster mit dem Thema "What is this thing?" aus der Hilfedatei Testhelp.hlp angezeigt wird, wenn der Benutzer die Taste F1 drückt, während das TESTHELP-Steuerelement in einem Container ausgeführt wird und den Tastaturfokus hat. Das Anzeigen der gesamten Hilfedatei bedeutet, dass, wenn der Benutzer F1 drückt, während das TESTHELP-Steuerelement in einem Container ausgeführt wird und den Tastaturfokus hat, das gesamte Hilfeprogramm in Windows aufgerufen wird und das Inhaltsthema der Datei Testhelp.hlp anzeigt.

  • Use Control's Help File
    Wenn diese Option aktiviert ist, wird die Hilfe in dem Format angezeigt, das von der Eigenschaft Type of Help to Use festgelegt wird, wenn der Benutzer die Taste F1 drückt, während das Steuerelement in einem Container ausgeführt wird und den Tastaturfokus hat.

  • Use ToolTip for this Control
    Wenn diese Option aktiviert ist, wird eine QuickInfo über dem Fenster des Steuerelements angezeigt, wenn das Steuerelement im Container ausgeführt wird und der Mauscursor in das Fenster des Steuerelements wechselt und darin anhält. Der anzuzeigende Text wird durch die Eigenschaft Tooltip Caption festgelegt.

  • Tooltip Caption
    Dies ist der Text, der in einer QuickInfo angezeigt werden soll, wenn der Benutzer die Anzeige von QuickInfos aktiviert.

    • Name1   Der oben im Steuerelement angezeigte Name.

    • Name2   Der in der Mitte des Steuerelements angezeigte Name.

    • Name3   Der unten im Steuerelement angezeigte Name.

Eigenschaftenseite "Farbe"

Hier können die Benutzer die Farben auswählen, die zum Zeichnen dieses Steuerelements verwendet werden sollen.

Eigenschaftenseite "Schriftart"

Hier können die Benutzer die Schriftart festlegen, die für den Text im Steuerelement verwendet werden soll.

Hinweis:

In diesem und einigen anderen Beispielen wurden die Änderungen an den Visual C++-Assistenten, -Bibliotheken und -Compilern noch nicht nachvollzogen. Sie demonstrieren aber dennoch, wie Sie die gewünschte Aufgabe durchführen können.

Schlüsselwörter

Das TESTHELP-Beispiel demonstriert die Verwendung der folgenden Klassen und Schlüsselwörter:

CToolTipCtrl; COleControl::OnDraw; COleControl::OnResetState; COlePropertyPage::OnHelp

Hinweis:

In diesem und einigen anderen Beispielen wurden die Änderungen an den Visual C++-Assistenten, -Bibliotheken und -Compilern noch nicht nachvollzogen. Sie demonstrieren aber dennoch, wie Sie die gewünschte Aufgabe durchführen können.

Siehe auch

Weitere Ressourcen

MFC-Beispiele