WRL 類別庫專案範本

如果您使用 Visual Studio 撰寫 Windows 執行階段 C++ 範本庫 (WRL) 專案，您可以下載 WRL 類別庫專案範本，大幅簡化您的工作。

注意事項
如果您必須手動更新現有專案的專案設定，請參閱 DLL (C++/CX)。

下載 WRL 專案範本

Visual Studio 不提供 WRL 專案的範本。 此如何下載建立 Windows 市集 應用程式的基本類別庫與 WRL的專案範本。

下載 WRL 專案範本

1. 在功能表列上，選擇 [檔案]、[新增專案]。

2. 在 [新增專案] 對話方塊的左窗格中，選取的 [上線]，然後選取 [樣板]。

3. 在右上角的 [搜尋線上範本]方塊中，輸入 WRL 類別庫。 當範本會出現在搜尋結果時，請選取 [確定] 按鈕。

4. 在 [下載及安裝] 對話方塊;因此，如果您同意授權條款，請選取 [安裝] 按鈕。

5. 安裝在範本上後，請選取 [檔案]， [新增專案]，然後選取 建立專案 WRLClassLibrary 範本。 專案建立 DLL。

使用專案範本的範例

讀取使用此範本來建立 Windows 執行階段 元件的範例 逐步解說：使用 WRL 建立基本 Windows 執行階段元件 。

專案範本提供哪些

測試專案範本提供:

• 宣告 MIDL 的 .idl 檔為基礎介面歸屬其類別實作。 以下為範例。

  import "inspectable.idl";
  import "Windows.Foundation.idl";
  
  #define COMPONENT_VERSION 1.0
  
  namespace WRLClassLibrary
  {
      interface IWinRTClass;
      runtimeclass WinRTClass;
  
      [uuid(89656677-8679-477c-aff1-f724c64b70f3), version(COMPONENT_VERSION), exclusiveto(WinRTClass)] 
      interface IWinRTClass : IInspectable
      {
      }
  
      [version(COMPONENT_VERSION), activatable(COMPONENT_VERSION)]
      runtimeclass WinRTClass
      {
          [default] interface IWinRTClass;
      }
  }
  

• 定義類別實作的 .cpp 檔案。 以下為範例。

  #include "pch.h"
  
  #include "WRLClassLibrary_h.h"
  #include <wrl.h>
  
  using namespace Microsoft::WRL;
  using namespace Windows::Foundation;
  
  namespace ABI
  {
      namespace WRLClassLibrary
      {
          class WinRTClass: public RuntimeClass<IWinRTClass>
          {
              InspectableClass(L"WRLClassLibrary.WinRTClass", BaseTrust)
  
          public:
              WinRTClass()
              {
              }
          };
  
          ActivatableClass(WinRTClass);
      }
  }
  

  RuntimeClass 基底類別來協助管理所有全域物件參考模組和宣告 IUnknown 和 IInspectable 介面的方法。 InspectableClass 巨集實作 IUnknown 和 IInspectable。 建立類別的執行個體的 ActivatableClass 巨集建立 Class Factory。

• 檔案名稱為定義程式庫匯出 DllMain、 DllCanUnloadNow、 DllGetActivationFactory和 DllGetClassObject的 module.cpp。

請參閱

概念

Windows Runtime C++ Template Library (WRL)