共用方式為

新增IDL MFC屬性

  • 發行項

[新增 IDL MFC 屬性精靈] 會將屬性新增至 Microsoft Framework 類別 （MFC） 專案中定義的介面定義連結庫 （IDL） 介面。

若要使用此精靈，您必須位於 MFC 專案、ActiveX 專案或支援 MFC 的 ATL 專案中。 例如，如果您有Microsoft ActiveX 控件專案，您可以使用下列程式將屬性新增至方案中的 IDL 介面。

將IDL MFC屬性新增至介面

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

  2. 在 [ 類別檢視] 窗格中，以滑鼠右鍵按下您要新增屬性之介面的名稱。

    注意

    您也可以將屬性新增至分配介面，除非專案有屬性，否則它會巢狀位於程式庫節點內。

  3. 從快捷方式功能表中，選擇 [新增>屬性]。

  4. 在 [ 新增 IDL MFC 屬性 精靈] 中，提供建立屬性的資訊。

  5. 選取 [ 確定 ] 以新增 屬性。

針對 MFC dispinterfaces：

  • 如果您選取 [成員變數 ] 做為實作類型，則會將方法和變數新增至實作它的類別。
  • 如果您選取 [Get/Set 方法] 作為實作類型，兩種方法會新增至實作它的類別。

使用者介面項目清單

下一節說明 新增 IDL MFC 屬性 精靈：

新增IDL MFC屬性的螢幕快照，其中包含兩個參數：int i 和char c。屬性類型為OLE_COLOR。

  • 屬性名稱

    設定屬性的名稱。

    針對與 ActiveX 控制項建立關聯的 MFC 分配介面 (Dispinterface)，您可以提供自己的名稱，或從預先定義的清單中選取內建屬性名稱。 如果您提供自己的屬性名稱，[內建] 實作類型無法使用。

    如需清單中股票屬性描述的詳細資訊，請參閱 股票屬性。

    介面類型 屬性名稱選項
    ATL 雙重介面、自訂介面和本機自訂介面 提供屬性名稱。
    MFC 分配介面 (Dispinterface)、MFC ActiveX 控制項分配介面 (Dispinterface) 提供屬性名稱，或從清單中選取內建屬性。

    如果您從清單中選取屬性，[屬性類型] 方塊中會顯示適當的值。 視 [實作類型] 選取專案而定 ，您可以變更此類型 。

  • 屬性類型

    設定您要新增的屬性類型。

    針對 MFC 分配介面 (Dispinterface)，提供您自己的類型，或從預先定義的清單中選取。 如果您提供屬性的股票實作， 則 Property 類型 是股票類型，而且無法變更。

  • 變數名稱

    設定與屬性建立關聯之成員變數的名稱。

    根據預設，變數名稱為 m_PropertyName。 您可以編輯此名稱。

    只有 MFC 散發介面才能看到此字段，而且如果您在 [實作類型] 下指定 Member 變數，

  • 通知函式

    設定屬性變更時所呼叫之通知函式的名稱。

    根據預設，通知函式的名稱是 OnPropertyNameChanged。 您可以編輯此名稱。

    只有 MFC 散發介面才能看到此字段，而且如果您在 [實作類型] 下指定 Member 變數，

  • Get 函式

    設定要取得屬性之函式的名稱。

    根據預設，函式 Get 的名稱是 GetPropertyName。 您可以編輯此名稱。

    如果您刪除名稱，則會將函式 GetNotSupported 插入介面分派對應。

    只有 MFC 散發介面才能看到此字段，而且如果您在 [實作類型] 下指定 Get/Set 方法，

  • Set 函式

    設定要設定屬性之函式的名稱。

    根據預設，函式 Set 的名稱是 SetPropertyName。 您可以編輯此名稱。

    如果您刪除名稱，則會將函式 SetNotSupported 插入介面分派對應。

    只有 MFC 散發介面才能看到此字段，而且如果您在 [實作類型] 下指定 Get/Set 方法，

  • 實作類型

    指定如何實作您要新增的屬性。

    僅適用於 MFC dispinterfaces。

    實作類型 描述
    內建 指定屬性名稱中所選取屬性的預設實作。 如需詳細資訊，請參閱內建屬性。
    如果您指定 [內建]，則 [屬性類型]、[參數類型] 和 [參數名稱] 都會呈暗灰色。
    成員變數 將屬性新增為成員變數。
    您可以新增自訂屬性或大多數內建屬性作為成員變數。
    在 [變數名稱] 和 [通知函式] 下提供預設名稱。 您可以編輯此名稱。
    您無法為、 或屬性指定 Member 變數。Text hWndCaption
    Get/Set 方法 指定屬性預設會新增為 GetPropertyName 和 SetPropertyName 函式。 這些名稱會出現在 [Get 函式] 和 [Set 函式] 下。
    您可以變更預設的 [屬性類型]，這會傳遞 Get 函式的值。
    您可以為 Get 及 Set 函式指定參數。

  • 預設屬性

    將屬性設定為介面的預設值。

    介面只能有一個預設屬性。

    指定預設屬性之後，您新增至介面的任何其他屬性都無法使用此複選框。 僅適用於 MFC dispinterface。

  • 參數

    顯示方法的參數及其類型。

  • +

    加入參數。 在 [ 參數] 中，輸入參數類型和名稱，然後選擇 [ 確定]。 例如，int x

  • x

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

  • [鉛筆] 圖示

    編輯選取的參數。

  • id

    設定識別屬性的數值識別碼。

    此選項不適用於自訂介面的屬性。 如需詳細資訊，請參閱 id MIDL 參考。

  • helpcontext

    指定內容識別碼，讓使用者可在說明檔中檢視此屬性的相關資訊。

    如需詳細資訊，請參閱 helpcontext MIDL 參考。

  • helpstring

    指定用來描述所套用元素的字元字串。 根據預設，它是 property屬性名稱。

    如需詳細資訊，請參閱 helpstring MIDL 參考。

內建屬性

如果您要將屬性新增至 MFC dispinterface，您可以從 [屬性名稱] 下拉式清單中選擇下列其中一個股票屬性：

屬性名稱 描述
Appearance 傳回或設定值，這個值可決定控制項的外觀。
控制項的 Appearance 屬性可以包含或省略立體顯示效果。 此屬性為環境讀取/寫入屬性。
BackColor 傳回控制項的環境 BackColor 屬性，或設定為調色盤 (RGB) 色彩或預先定義的系統色彩。
根據預設，其值會對應至控制項容器的前景色彩。
此屬性為環境讀取/寫入屬性。
BorderStyle 傳回或設定控制項的框線樣式。
此屬性為讀取/寫入屬性。
Caption 傳回或設定控制項的 Caption 屬性。
Caption 是視窗的標題。 Caption 沒有 [成員變數] 實作類型。
Enabled 傳回或設定控制項的 Enabled 屬性。
啟用的控制項可以回應使用者產生的事件。
Font 傳回或設定控制項的環境字型。
Null 如果控制件沒有字型，則為 。
ForeColor 傳回或設定控制項的環境 ForeColor 屬性。
hWnd 傳回或設定控制項的 hWnd 屬性。
沒有 成員變數 實作類型。
ReadyState 傳回或設定控制項的 ReadyState 屬性。
控制項可以是未初始化、已初始化、正在載入、互動式或完成。
如需詳細資訊，請參閱網際網路 SDK 中的 READYSTATE。
Text 傳回或設定控制項內含的文字。
沒有 成員變數 實作類型。

另請參閱

Add 屬性

新增IDL屬性