ATLPages-Beispiel: Implementiert eine Eigenschaftenseite mit IPropertyPageImpl
Das ATLPages-Beispiel veranschaulicht die Implementierung einer Eigenschaftenseite mithilfe von IPropertyPageImpl.
Dieses Beispiel besteht aus:
A property page class, CDocumentProperties, that uses the EnvDTE::Documentinterface to display (and allow changes to) the properties of a text document.
Einer Hilfskomponente, CHelper, die einen einfachen Wrapper für das OleCreatePropertyFrame-API für Skriptsprachen verfügbar macht.
Ein einfachen Testmakro, Test im ATLPages.vsmacros-Projekt, die den Helfer, verwendet um die Eigenschaftenseite für das aktive Dokument innerhalb der Visual C++-Editors anzuzeigen.
.gif "Sicherheitshinweis") Sicherheitshinweis |
|---|
Dieser Beispielcode soll ein Konzept veranschaulichen, und es wird nur den Code, der für dieses Konzept relevant sind. Möglicherweise erfüllt dieser nicht die Sicherheitsanforderungen für eine bestimmte Umgebung, und er sollte nicht genau wie dargestellt verwendet werden. Wir empfehlen, Sicherheits- und Fehlerbehandlungscode hinzuzufügen, um Ihre Projekte sicherer und stabiler zu machen. Microsoft stellt diesen Beispielcode "Wie besehen"keine Garantien. |
So erhalten Sie Beispiele und Anweisungen für deren Installation:
Um Beispiele von Visual Studio zuzugreifen
im Menü Hilfe Menü klicken Beispiele.
Standardmäßig sind die Beispiele in installiert. Laufwerk: \Programme\Microsoft visual Studio 10.0\Samples\.
- Die neueste Version dieses Beispiels und eine Liste der anderen Beispiele finden Sie unter Visual Studio Samples auf der MSDN-Website.
Erstellen und Ausführen des Beispiels
Um das Beispiel auszuführen, müssen Sie so erstellen die Projektmappe und führen Sie das Testmakro.
Dieses Beispiel erstellen
Öffnen Sie die Projektmappendatei ATLPages7.sln.
Erstellen Sie aus der Menü, und klicken Sie auf Projektmappe.
Ausführen des Makros
Öffnen Sie ein Textdokument im Editor. Öffnen Sie z. B. eine der die Quelldateien für das ATLPages-Beispiel.
Im Menü Extras Makros auf, und klicken Sie dann auf Makro-Explorer. Dadurch wird Fenster Makro-Explorer geöffnet.
Im Menü Extras Makros auf, und klicken Sie dann auf Makroprojekt laden. Dadurch wird das Dialogfeld Makroprojekt hinzufügen mit öffnen.
Wechseln Sie zu dem Speicherort der Datei ATLPages.vsmacros (es befindet sich in demselben Ordner wie das ATLPages-Beispiel), und klicken Sie auf die Schaltfläche, öffnen . Diese Aktion wird die Datei Makros geladen und im Makro-Explorer angezeigt wird.
Erweitern Sie den ATLPages-Knoten, und doppelklicken Sie auf das Testmakro .
Wenn kein Textdokument beim Ausführen des Makros geöffnet ist, wird nichts. Wenn ein Dokument geöffnet ist, wird eine Eigenschaftenseite für das Dokument angezeigt, das den Namen der Datei und seinen Schreibschutzstatus angibt. Sie können eines dieser Elemente ändern. Ihre Änderungen werden angewendet, wenn Sie die übernehmen oder OK Schaltfläche klicken. Ändern des Namens der Datei wird die Datei gespeichert werden auf dem Datenträger unter dem neuen Namen. Ändern des Nur-Lese-Status der Datei bestimmt, ob die Datei innerhalb der Visual C++-Editors geändert werden kann (es nicht das Attribut schreibgeschützt der Datei auf Datenträger aus).
Hinweis
Ändern der nur-Lesen-Eigenschaft eines Dateien unter Quellcodeverwaltung ist nicht möglich dieser Eigenschaftenseite.
Schlüsselwörter
In diesem Beispiel werden die folgenden Schlüsselwörter verwendet:
IPropertyPage, IPropertyPageImpl, OleCreatePropertyFrame, IPropertyPage::SetObjects, IPropertyPage::Activate, IPropertyPage::Apply, EnvDTE