分享方式：

新增 IDL 方法

  • 文章

新增 IDL 方法精靈會將方法新增至介面定義程式庫 (IDL) 介面，例如在包含 IDL 檔案的 ATL 專案中。 此精靈在支援 MFC 的專案中不適用。

此精靈與 [新增方法精靈] 和 [新增 IDL MFC 方法精靈] 在下列幾方面不同：

  • [新增方法精靈] 會將方法新增至專案中的介面，並可更新與介面相關聯的類別。
  • [新增 IDL MFC 方法] 精靈則專屬於支援 MFC 的 MFC、ActiveX 或 ATL 專案。

將方法新增至 IDL 介面

  1. 在 [檢視] 功能表上，選取 [類別檢視]。

  2. 在 [類別檢視] 窗格中，展開專案節點，以顯示您要新增方法的 IDL 介面 (.idl 檔案)。

  3. 以滑鼠右鍵按一下介面的名稱。

  4. 選取捷徑功能表上的 [新增]>[方法]。

  5. 在 [新增 IDL 方法] 精靈中，提供用於建立方法的資訊。

  6. 選取 [確定] 以新增方法。

使用者介面元素清單

下一節會描述您將用於新增方法的精靈介面：

使用精靈新增方法的螢幕擷取畫面。顯示兩個參數：[ in ] int i 和 [ in ] float f。傳回型別為 HRESULT。選取從型別推斷 in out 參數值

  • 方法名稱

    提供方法的名稱。

  • 傳回類型

    方法傳回的資料類型。 從介面中定義的方法傳回錯誤碼的標準方式是使用 HRESULT。

    下表會描述您可以對其新增方法的不同介面種類，以及允許的傳回型別。 針對雙重和自訂介面，傳回型別必須是 HRESULT，而且精靈不會允許您變更它。

    介面種類 傳回類型
    雙重介面 HRESULT. 無法變更。
    自訂介面 HRESULT. 無法變更。
    本機自訂介面 提供您自己的傳回型別，或從下拉式清單中選取。
    分配介面 提供您自己的傳回型別，或從下拉式清單中選取。

  • 參數

    顯示方法的參數、修飾元和型別。

  • +

    新增 參數。 在 [參數] 中，輸入參數型別、名稱和任何修飾元。 例如 [in] int i，並選擇 [確定]。

  • x

    從 [參數] 清單中移除選取的參數。

  • 從型別推斷 in/out 參數值

    根據參數的型別插入 [in] 或 [out] 屬性。

  • 將最後一個參數設定為傳回值 (retval)

    最後一個參數會被視為方法的傳回值。

  • 屬性

    在 MIDL 參考中也會描述下列屬性。

    • id

      設定識別方法的數值識別碼。 如需詳細資訊，請參閱id。

    • call_as

      指定要對應至這個本機方法之遠端方法的名稱。 如需詳細資訊，請參閱call_as。

    • helpcontext

      指定內容識別碼，讓使用者可在說明檔中檢視此方法的相關資訊。 如需詳細資訊，請參閱helpcontext。

    • helpstring

      指定用於描述所套用元素的字元字串。 如需詳細資訊，請參閱helpstring。

  • 其他屬性

    • hidden

      表示項目存在，但不應該在使用者導向的瀏覽器中顯示。 如需詳細資訊，請參閱hidden。

    • local

      指定介面或函式並非遠端。 如需詳細資訊，請參閱local。

    • restricted

      指定無法任意呼叫的模組、介面或分配平面的程式庫或成員。 如需詳細資訊，請參閱restricted。

    • source

      表示事件來源是 coclass、屬性或方法的成員。 對於 coclass 的成員，此屬性指對該成員呼叫而不是實作。 如需詳細資訊，請參閱source。

另請參閱

新增方法精靈
新增 IDL MFC 方法精靈