共用方式為

名稱、加入屬性精靈

  • 發行項

更新：2007 年 11 月

使用此精靈將屬性加入至介面。

  • 屬性型別
    設定所加入屬性的型別。為 MFC 分配介面提供您自己的自訂型別或從預先定義的清單上選取。如果您提供屬性的內建 (Stock) 實作，屬性型別 (Property Type) 會設定成內建型別，並且無法變更。

  • 屬性名稱
    設定此屬性的名稱。您可以對於與 ActiveX 控制項關聯的 MFC 分配介面提供自己的名稱，或是從預先定義的清單上選取一個內建屬性。如果您提供自己的屬性名稱，將無法使用內建實作型別。如需清單上屬性的說明，請參閱內建屬性。

    介面型別

    說明

    ATL 雙重介面 (Dual Interface)、自訂介面和局部自訂介面

    提供一個屬性名稱。

    MFC 分配介面、MFC ActiveX 控制項分配介面

    提供一個屬性名稱或從清單上選取一個內建屬性。如果從清單上選取屬性，則 [屬性型別] 方塊上會出現適當的數值。您可以依您在 [實作類型] 所做的選項而定，變更這個型別。

  • 傳回型別
    僅用於 ATL 介面。設定屬性的傳回型別 (Return Type)。雙重介面的傳回型別永遠是 HRESULT 且無法使用這個方塊。若是自訂介面，您則可以從清單中選取傳回型別。但是仍然建議使用 HRESULT，因為它提供傳回錯誤的標準方法。

  • 變數名稱
    僅用於 MFC 分配介面。只有當您在 [實作類型] 中指定 [成員變數] 時，才可以使用。設定這個與屬性關聯的成員變數 (Member Variable) 名稱。變數名稱預設值為 m_PropertyName。您可以編輯該名稱。

  • 告知函式
    僅用於 MFC 分配介面。只有當您在 [實作類型] 中指定 [成員變數] 時，才可以使用。設定當屬性變更時被呼叫的告知函式名稱。告知函式名稱預設值為 OnPropertyNameChanged。您可以編輯該名稱。

  • Get 函式
    用於 MFC 分配介面。只有當您在 [實作類型] 中指定 [Get/Set 方法] 時，才可以使用。設定這個函數名稱以取得屬性。Get 函式名稱預設值為 GetPropertyName。您可以編輯該名稱。如果您將名稱刪除，則 GetNotSupported 函式會插入介面分派對應 (Dispatch Map)。GetPropertyName 函式將屬性指定為可讀取。

  • Set 函式
    僅用於 MFC 分配介面。只有當您在 [實作類型] 中指定 [Get/Set 方法] 時，才可以使用。設定這個函式的名稱以設定屬性。Set 函式名稱預設值為 SetPropertyName。您可以編輯該名稱。如果您將名稱刪除，則 SetNotSupported 函式會插入介面分派對應。SetPropertyName 函式會將這個屬性指定為可寫入。

  • 實作類型
    僅用於 MFC 分配介面。指定加入屬性的實作方式。

    實作類型

    說明

    內建

    為在 [屬性名稱] 中選取的屬性指定一個內建實作。預設值。如需詳細資訊，請參閱內建屬性。

    如果您指定 [內建]，則 [屬性型別]、[參數型別] 和 [參數名稱] 會變成暗灰色的 (Dimmed)。

    成員變數

    指定將這個屬性做為成員變數加入。您可以將自訂屬性或大多數內建屬性當做成員變數加入。您無法對 Caption、hWnd 和 Text 屬性指定 [成員變數]。

    [變數名稱] 和 [告知函式] 中提供預設名稱。您可以編輯該名稱。

    Get/Set 方法

    依照預設，指定這個屬性加入為 GetPropertyName 和 SetPropertyName 函式。這些名稱顯示於 [Get 函式] 和 [Set 函式] 下方。

    您可以變更預設的 [屬性型別]，該型別傳遞一個數值給 Get 函式。您可以指定 Get 和 Set 函式的參數。

  • Get 函式
    用於 ATL 介面。將屬性設定為可讀取；也就是，將產生一個 Get 方法以從物件上擷取屬性。您必須選取 Get、Put 或兩者都選。

  • Put 函式
    僅用於 ATL 介面。將屬性設定為可寫入；也就是，它將產生 Put 方法以設定或「放置」物件的屬性。您必須選取 Get、Put 或兩者都選。如果您選取這個選項，您可以選擇下列兩種方式來實作這個方法：

    選項

    描述

    PropPut

    PropPut 函式會傳回物件的複本。這是預設設定，也是將屬性設定為可寫入最常使用的方式。

    PropPutRef

    PropPutRef 函式會傳回物件的參考，而不會傳回物件本身的複本。對於初始化負擔較大的物件，例如大型的結構或陣列，請考慮使用這個選項。

  • 參數屬性
    僅用於 ATL 介面。設定由 [參數名稱] 指定的參數是否是 in、out、或兩者皆非。

    選項

    描述

    in

    指示參數從呼叫程序傳遞到被呼叫程序。

    out

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

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

  • 參數名稱
    若該屬性具有參數，設定您所加入屬性參數的名稱。按一下 [加入] 之後，參數名稱會出現在 [參數清單] 中。

  • 參數清單
    顯示要加入至屬性的屬性清單。清單中的每一個項目是由參數名稱、參數型別和屬性所組成。使用 [加入] 和 [移除] 來更新清單。

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

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

  • 預設屬性
    僅用於 MFC 分配介面。將這個屬性設定為介面的預設設定。介面只能有一個預設屬性；一旦您指定了預設屬性，加入至介面的其他屬性將無法使用這個方塊。

請參閱

工作

加入屬性

實作介面

參考

加入屬性精靈、IDL 屬性