共用方式為

ATLPages 範例：使用 IPropertyPageImpl 實作屬性頁

  • 發行項

更新：2007 年 11 月

ATLPages 範例示範如何使用 IPropertyPageImpl 來實作屬性頁。

本範例由下列部分組成：

  • 屬性頁類別 CDocumentProperties，會使用 EnvDTE::Document 介面以顯示 (並允許變更) 文字文件的屬性。

  • Helper 元件 CHelper，會向指令碼語言公開簡化的 OleCreatePropertyFrame API 包裝函式。

  • 一個簡單的測試巨集 Test (位在 ATLPages.vsmacros 專案中)，會使用 Helper 來顯示 Visual C++ 編輯器中作用中文件的屬性頁。

安全性注意事項：

這個程式碼範例僅供概念說明之用，同時因為範例中的程式碼撰寫並沒有周全的顧及所有安全性問題，所以本範例不適用於實際執行的應用程式或網站中。如果使用者擅自將範例程式碼用於其他意圖而導致連帶事件或重大損害時，Microsoft 將不承擔任何責任。

若要取得範例和指示以便進行安裝：

  • 按一下 Visual Studio [說明] 功能表上的 [範例]。

    如需詳細資訊，請參閱尋找範例檔案。

  • 最新版的完整範例清單可從 Visual Studio 2008 範例網頁 (英文) 取得。

  • 您也可以將範例置於電腦硬碟中。根據預設，範例和讀我檔案都會複製到 \Program Files\Visual Studio 9.0\Samples\ 下的資料夾中。對於所有的 Visual Studio Express 版，所有範例都可在線上找到。

建置和執行範例

若要執行本範例，您將需要建置 (Build) 本方案，然後執行測試巨集。

若要建置這個範例

  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 範例