Образец ATLPages: реализация страницы свойств с помощью IPropertyPageImpl

Статья
11/05/2008

Обновлен: Ноябрь 2007

В образце ATLPages показана реализация страницы свойств с помощью IPropertyPageImpl.

Этот образец состоит из следующих компонентов.

Класс страницы свойств CDocumentProperties, который использует интерфейс EnvDTE::Document для отображения свойств текстового документа и позволяет изменять эти свойства.
Вспомогательный компонент CHelper, который предоставляет доступ к упрощенной оболочке для API-интерфейса OleCreatePropertyFrame из языков сценария.
Простой тестовый макрос Test в проекте ATLPages.vsmacros, который использует вспомогательный компонент для отображения страницы свойств активного документа в редакторе Visual C++.

Примечание о безопасности.
Этот образец кода служит для демонстрации основных принципов и не предназначен для использования в приложениях или на веб-узлах, поскольку не может считаться примером наиболее безопасного кода. Корпорация Майкрософт не несет ответственности за случайные или косвенные убытки в случае использования образца кода не по назначению.

Этот образец кода служит для демонстрации основных принципов и не предназначен для использования в приложениях или на веб-узлах, поскольку не может считаться примером наиболее безопасного кода. Корпорация Майкрософт не несет ответственности за случайные или косвенные убытки в случае использования образца кода не по назначению.

Чтобы получить образцы и инструкции по их установке, выполните следующие действия.

В меню Справка среды Visual Studio выберите пункт Примеры.

Дополнительные сведения см. в разделе Поиск файлов примеров.
Самая последняя версия и полный список образцов доступны в Интернете на странице образцов Visual Studio 2008.
Кроме того, образцы находятся на жестком диске компьютера. По умолчанию образцы кода и файл Readme копируются в папку, находящуюся в папке \Program Files\Visual Studio 9.0\Samples\. Все образцы кода для экспресс-выпусков Visual Studio находятся в Интернете.

Построение и запуск образца

Для запуска образца необходимо построить решение, а затем запустить тестовый макрос.

Построение этого образца

Откройте файл решения ATLPages7.sln.
В меню Построение выберите команду Построить решение.

Выполнение макроса

Откройте текстовый документ в редакторе. Например, откройте один из файлов исходного кода для образца ATLPages.
В меню Сервис укажите пункт Макросы и выберите пункт Обозреватель макросов. Откроется окно "Обозреватель макросов".
В меню Сервис укажите пункт Макросы и выберите пункт Загрузить макропроект. Откроется диалоговое окно Добавление макропроекта.
Перейдите к расположению файла ATLPages.vsmacros (он находится в той же папке, что и образец ATLPages) и нажмите кнопку Открыть. Будет загружен файл макросов, и он появится в обозревателе макросов.

Разверните узел ATLPages и дважды щелкните макрос Test.

Если во время запуска макроса не открыт ни один текстовый документ, макрос не выполняет никаких действий. Если открыт документ, будет выведена страница свойств для этого документа, в которой показано имя файла и его состояние доступности только для чтения. Можно изменить любой из этих элементов. Изменения будут применены после нажатия кнопки Применить или ОК. После изменения имени файла он будет сохранен на диске под новым именем. Изменение состояния доступности только для чтения влияет на возможность изменения файла в редакторе Visual C++ (но не влияет на атрибут доступности только для чтения файла на диске).

Примечание.
С помощью этой страницы свойств нельзя изменить свойство доступности только для чтения файлов, включенных в систему управления исходным кодом.

Ключевые слова

В этом образце используются следующие ключевые слова:

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

См. также

Другие ресурсы

Образцы ATL

Поделиться через