通过

ATLPages 示例：使用 IPropertyPageImpl 实现属性页

  • 项目

更新：2007 年 11 月

ATLPages 示例说明使用 IPropertyPageImpl 来实现属性页。

此示例由以下部分组成：

  • 属性页类 CDocumentProperties，该类使用 EnvDTE::Document 接口来显示（并允许更改）文本文档的属性。

  • 帮助器组件 CHelper，该组件向脚本语言公开 OleCreatePropertyFrame API 简化的包装。

  • 一个简单的测试宏，即 ATLPages.vsmacros 项目中的 Test，该宏使用帮助器在 Visual C++ 编辑器内显示活动文档的属性页。

安全说明：

提供该示例代码是为了阐释一个概念，并不代表着最安全的编码实践，因此不应在应用程序或网站中使用该示例代码。对于超出本示例代码的预期用途以外的使用所造成的偶然或继发性损失，Microsoft 不承担任何责任。

获取示例和安装示例的说明：

  • 在 Visual Studio 的“帮助”菜单上，单击“示例”。

    有关更多信息，请参见定位示例文件。

  • 示例的最新版本和完整列表可以从 Visual Studio 2008 Samples page（Visual Studio 2008 示例页面）联机获取。

  • 还可以在计算机的硬盘上查找示例。默认情况下，示例和自述文件将复制到 \Program Files\Visual Studio 9.0\Samples\ 下的文件夹中。对于 Visual Studio 速成版，所有示例都位于联机位置。

生成并运行示例

若要运行该示例，需要生成解决方案，然后运行测试宏。

生成此示例

  1. 打开解决方案文件 ATLPages7.sln。

  2. 在“生成”菜单中，单击“生成解决方案”。

运行宏

  1. 在编辑器内打开一个文本文档。例如，打开 ATLPages 示例的一个源文件。

  2. 从“工具”菜单中，指向“宏”，然后单击“宏资源管理器”。这将打开“宏资源管理器”窗口。

  3. 从“工具”菜单中，指向“宏”，然后单击“加载宏项目”。这将打开“添加宏项目”对话框。

  4. 浏览到 ATLPages.vsmacros 文件所在的位置（该文件与 ATLPages 示例位于同一文件夹中），单击“打开”按钮。该操作将加载宏文件，该宏文件将出现在“宏资源管理器”中。

  5. 展开 ATLPages 节点并双击 Test 宏。

    如果运行此宏时没有打开任何文本文档，则此宏不进行任何操作。如果有文档打开，则将显示该文档的属性页，指示文件的名称及其只读状态。其中任何一项均可以更改。单击“应用”或“确定”按钮后将应用更改。更改文件名将导致文件以新名称保存到磁盘。更改文件的只读状态将影响是否可以在 Visual C++ 编辑器内更改该文件（但并不影响磁盘上该文件的只读属性）。

    说明：

    不能使用此属性页更改源代码管理下的文件的只读属性。

关键字

此示例使用以下关键字：

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

请参见

其他资源

ATL 示例