MFC ActiveX 控制項：進階屬性實作

發行項
06/10/2015

本文將 ActiveX 控制項說明主題與實作進階屬性相關:

唯讀和唯寫屬性
傳回屬性中的錯誤碼

唯讀和唯寫屬性

加入屬性精靈會提供快速而輕鬆的方式實作控制項的唯讀或唯寫屬性。

實作唯讀或唯寫屬性

載入控制項的專案。
在類別檢視中，展開您的控制項程式庫節點。
以滑鼠右鍵按一下控制項的 (程式庫節點的第二個節點介面節點) 開啟捷徑功能表。
從捷徑功能表上，按一下 Add 然後按一下 [加入屬性]。

這樣會開啟加入屬性精靈。
在 Property Name 方塊中，輸入您的屬性名稱。
對於 Implementation Type，按一下 Get/Set Methods。
在 Property Type 方塊中，為屬性選取適當的型別。
如果您想要唯讀屬性，清除集合函式名稱。如果您想要唯寫屬性，請清除 Get 函式名稱。
按一下 [完成]。

這樣做時，加入屬性精靈會在分派對應項目插入函式 SetNotSupported 或 GetNotSupported 在一般集合或 Get 函式位置。

若要變更現有的屬性是唯讀或唯寫，您可以手動編輯分派對應和從控制項移除不必要的設定或取得函式。

如果您希望屬性條件式唯讀或唯寫的 (例如，在中，只有在您的控制項處於特定模式下操作)，在適當時您可以設定或取得函式，一般，並呼叫 SetNotSupported 或 GetNotSupported 函式。例如：

void CMyAxUICtrl::SetMyProperty(SHORT newVal)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());

   if (m_bReadOnlyMode)   //  some control-specific state
   {
      SetNotSupported();
   }
   else
   {
      m_iPropVal = newVal;   //  set property as normal
      SetModifiedFlag();
   }
}

如果 m_bReadOnlyMode 資料成員是 TRUE，這個程式碼範例會呼叫 SetNotSupported 。如果 FALSE，屬性就會設定為新值。

傳回屬性中的錯誤碼

表示發生錯誤時，會嘗試取得或設定屬性，請使用 COleControl::ThrowError 函式，採用 SCODE (狀態碼) 做為參數。您可以使用預先定義的 SCODE 或定義人員你。如需預先定義 SCODE所定義的自訂 SCODE清單和指示，請參閱下列文章 ActiveX 控制項的在您的 ActiveX 控制項的處理錯誤 :進階主題。

Helper 函式為最常用的預先定義 SCODE存在，例如 COleControl::SetNotSupported、 COleControl::GetNotSupported和 COleControl::SetNotPermitted。

注意事項
ThrowError 被視為只用來做為傳回錯誤的方法是從屬性取得的內部或 Set 函式或自動化方法。這些是唯一的紀元適當的例外處理常式會出現在堆疊。