加入方法精靈

使用這個精靈來將方法加入介面。 依據要加入方法的專案類型或介面型別,此精靈將顯示不同的選項。

名稱

  • 傳回型別
    由該方法傳回的資料型別。 建議對所有介面型別使用 HRESULT,因為它提供了傳回錯誤的標準方法。

    介面型別

    描述

    雙重介面

    HRESULT. 無法變更。

    自訂介面

    HRESULT. 無法變更。

    本機自訂介面

    提供自訂的傳回型別,或從清單上選取。

    分配介面

    提供自訂的傳回型別,或從清單上選取。

    MFC ActiveX 控制項分配介面

    如果您實作一個內建方法,則傳回型別會設定成適當的值,且無法變更它。 如果您從 [方法名稱] 清單上選取一個方法,並且按一下 [選擇方法型別] 下的 [自訂],則請從清單上選取一個傳回型別。

  • 方法名稱
    設定此方法的名稱。

    介面型別

    描述

    ATL 雙重介面、自訂介面和本機自訂介面

    提供自訂的方法名稱。

    MFC 分配介面

    提供自訂的方法名稱或從清單上選取建議的方法名稱。 如果您從清單上選取一個名稱,[傳回型別] 方塊內會出現適當的數值,並且無法變更它。

    MFC ActiveX 控制項分配介面

    提供自訂的方法或選取 DoClickRefresh 任一種內建方法。 如需詳細資訊,請參閱 MFC ActiveX 控制項:加入內建方法

  • 方法型別
    只有 MFC ActiveX 控制項可以使用。 如果您在 [方法名稱] 方塊中提供一個方法名稱,而非從清單上選取一個方法,則此方塊無法使用。

    如果您在 [方法名稱] 清單上選取其中一個方法,請選取內建實作 (Implementation) 或自訂實作。

    方法型別

    說明

    內建

    預設值。 在 [方法名稱] 清單中插入您選取之方法的內建實作。 如果您選取 [內建],則無法變更 [傳回型別]。

    自訂

    插入於 [方法名稱] 清單中選取之方法的 Stub 實作。 對於自訂方法型別,您可以提供您自訂的傳回型別,或從 [傳回型別] 清單上選取一個。

  • 內部名稱
    只有加入至 MFC 分配介面的自訂方法可以使用。 設定用於分派對應 (Dispatch Map)、標頭檔 (.h) 和實作檔 (.cpp) 的名稱。 依照預設,這個名稱和 [方法名稱] 相同。 如果您使用 MFC 分配介面,或者如果您將自訂方法加入至 MFC ActiveX 控制項分配介面上,則您可以變更該方法名稱。

    介面型別

    說明

    ATL 雙重介面、自訂介面和本機自訂介面

    無法使用

    MFC 分配介面

    預設為方法名稱, 您可編輯此內部名稱。

    MFC ActiveX 控制項分配介面

    您只能設定自訂方法的內部名稱, 內建方法並不使用內部名稱。

  • 參數屬性
    設定在 [參數名稱] 中指定之參數的任何其他屬性。

    參數屬性

    說明

    允許的組合

    位於

    表示參數從呼叫程序傳遞至被呼叫程序。

    只限 in

    inout

    Out

    表示指標參數從被呼叫的程序傳回到呼叫程序 (從伺服器到用戶端)。

    只限 out

    inout

    outretval

    Retval

    表示參數接收成員的傳回值。

    retval 和 out

  • 參數型別
    設定參數的資料型別。 從清單中選取型別。

  • 參數名稱
    設定透過方法傳遞的參數名稱。 輸入名稱之後,必須按一下 [加入] 以將它加入至會透過方法傳遞的參數清單上。 如果沒有提供參數名稱,則精靈會忽略任一個參數屬性 (僅 ATL) 或 [參數型別] 的選取項目。

    按一下 [加入] 之後,參數名稱會出現在 [參數清單] 中。

    **注意:**如果您在輸入參數名稱後先按一下 [完成],再按一下 [加入],則參數不會加入至方法中。 而必須尋找該方法,然後手動插入參數。

  • 加入
    將您在 [參數名稱] 中指定的參數與其型別和參數屬性加入至 [參數清單]。 您必須按一下 [加入] 才能將參數加入清單。

  • Remove
    將您在 [參數清單] 中選取的參數從清單中移除。

  • 參數清單
    顯示方法目前已加入的所有參數、修飾詞 (Modifier) 和型別。 加入參數時,精靈會更新 [參數清單] 以顯示每一個參數、參數的修飾詞和型別。

請參閱

工作

加入方法

參考

IDL 屬性、加入方法精靈