ATLPages-Beispiel: Implementiert eine Eigenschaftenseite mit "IPropertyPageImpl"

  • Artikel

Aktualisiert: November 2007

Das ATLPages-Beispiel zeigt die Implementierung einer Eigenschaftenseite mithilfe von IPropertyPageImpl.

Das Beispiel besteht aus folgenden Komponenten:

  • Einer Eigenschaftenseitenklasse, CDocumentProperties, in der mithilfe der EnvDTE::Document-Schnittstelle Eigenschaften eines Textdokuments angezeigt (und geändert) werden können.

  • Einer Hilfskomponente, CHelper, die einen einfachen Wrapper für die OleCreatePropertyFrame-API für Skriptsprachen verfügbar macht.

  • Einem einfachen Testmakro, Test im ATLPages.vsmacros-Projekt, das mit der Hilfskomponente die Eigenschaftenseite für das aktive Dokument innerhalb des Visual C++-Editors anzeigt.

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

Um das Beispiel auszuführen, müssen Sie erst die Projektmappe erstellen und dann das Testmakro ausführen.

So erstellen Sie dieses Beispiel

  1. Öffnen Sie die Projektmappendatei ATLPages7.sln.

  2. Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

So führen Sie das Makro aus

  1. Öffnen Sie ein Textdokument im Editor. Öffnen Sie z. B. eine Quelldatei für das ATLPages-Beispiel.

  2. Zeigen Sie im Menü Extras auf Makros, und klicken Sie dann auf Makro-Explorer. Das Fenster Makro-Explorer wird geöffnet.

  3. Zeigen Sie im Menü Extras auf Makros, und klicken Sie dann auf Makroprojekt laden. Das Dialogfeld Makroprojekt hinzufügen wird geöffnet.

  4. Suchen Sie nach dem Speicherort der Datei ATLPages.vsmacros (sie befindet sich im gleichen Ordner wie das ATLPages-Beispiel), und Sie klicken auf die Schaltfläche Öffnen. Dadurch wird die Makrodatei geladen und im Makro-Explorer angezeigt.

  5. Erweitern Sie den ATLPages-Knoten, und doppelklicken Sie auf das Makro Test.

    Wenn kein Textdokument geöffnet ist, hat das Makro keine Auswirkungen. Ist jedoch ein Dokument geöffnet, wird für dieses Dokument eine Eigenschaftenseite mit dem Dateinamen und dem Schreibschutzstatus angezeigt. Sie können jedes dieser Elemente ändern. Diese Änderungen werden übernommen, sobald Sie auf die Schaltfläche Übernehmen oder OK klicken. Wenn Sie den Dateinamen ändern, wird die Datei auf der Festplatte unter dem neuen Namen gespeichert. Änderungen des Schreibschutzstatus beeinflussen, ob die Datei innerhalb des Visual C++-Editors geändert werden kann (haben jedoch keine Auswirkung auf das Schreibschutzattribut der Datei auf der Festplatte).

    Hinweis:

    Auf dieser Eigenschaftenseite können keine Änderungen an der Schreibschutzeigenschaft von Dateien vorgenommen werden, die von der Quellcodeverwaltung kontrolliert werden.

Schlüsselwörter

In diesem Beispiel werden die folgenden Schlüsselwörter verwendet:

IPropertyPage, IPropertyPageImpl, OleCreatePropertyFrame, IPropertyPage::SetObjects, IPropertyPage::Activate, IPropertyPage::Apply, EnvDTE

Siehe auch

Weitere Ressourcen

ATL-Beispiele