CStockPropImpl 類別

這個類別會提供對支援內建屬性值的方法。

重要事項
這個類別和其成員不能用於 Windows 執行階段執行的應用程式。

template <
class T,
class InterfaceName, 
const IID* piid= &_ATL_IIDOF(InterfaceName), 
const GUID* plibid= &CComModule::m_libid, 
WORD wMajor= 1,
WORD wMinor= 0, 
class tihclass= CcomTypeInfoHolder
>
class ATL_NO_VTABLE CStockPropImpl :
public IDispatchImpl< InterfaceName, piid, plibid, wMajor,
   wMinor, tihclass>

參數

• T
  實作控制項和 CStockPropImpl衍生自的類別。

• InterfaceName
  公開內建屬性的雙重介面。

• piid
  為 InterfaceNameIID 的指標。

• plibid
  對型別包含 InterfaceName定義之程式庫的 GUID 的指標。

• wMajor
  型別程式庫的主要版本。預設值為 1。

• wMinor
  型別程式庫的次要版本。預設值為 0。

• tihclass
  所使用的類別處理 T的型別資訊。預設值是 CComTypeInfoHolder。

Members

公用方法

get_Appearance	呼叫這個方法會取得繪製樣式使用控制項，例如，一般或 3D。
get_AutoSize	呼叫這個方法會取得表示旗標狀態的控制項不能是其他大小。
get_BackColor	呼叫這個方法會取得控制項的背景色彩。
get_BackStyle	呼叫這個方法會取得控制項的背景樣式，透明或不透明。
get_BorderColor	呼叫這個方法會取得控制項的框線色彩。
get_BorderStyle	呼叫這個方法會取得控制項的框線樣式。
get_BorderVisible	呼叫這個方法會取得表示旗標狀態的控制項框線是否為可見。
get_BorderWidth	呼叫這個方法會取得寬度 (以像素為單位) 的控制項的框線。
get_Caption	呼叫這個方法會取得指定物件中的文字標題。
get_DrawMode	呼叫這個方法會取得控制項的繪製模式，例如，位元 XOR 筆或反轉色彩。
get_DrawStyle	呼叫這個方法會取得控制項的繪製模式，例如，實線，虛線則為多了。
get_DrawWidth	呼叫這個方法會取得繪圖寬度 (以像素為單位) 使用控制項的繪圖方法。
get_Enabled	呼叫這個方法會取得表示旗標狀態的控制項。
get_FillColor	呼叫這個方法會取得控制項的填滿色彩。
get_FillStyle	呼叫這個方法會取得控制項的填滿模式，例如，實線，透明或跨平台的縮放繪製。
get_Font	呼叫這個方法可以使用控制項的字型屬性。
get_ForeColor	呼叫這個方法會取得控制項的前景色彩。
get_HWND	呼叫這個方法會取得視窗控制代碼關聯的控制項。
get_MouseIcon	呼叫這個方法會取得圖形 (圖示、點陣圖、中繼檔圖片) 的屬性時，就會顯示滑鼠指標在控制項中。
get_MousePointer	當滑鼠指標在控制項，例如，箭號、十字或沙漏時，呼叫這個方法會取得滑鼠指標的型別中。
get_Picture	呼叫這個方法取得指標圖形 (圖示、點陣圖、中繼檔圖片) 的屬性隨即顯示。
get_ReadyState	呼叫這個方法會取得控制項的就緒狀態，例如，載入或載入。
get_TabStop	呼叫這個方法會取得值的旗標會控制是否是定位停駐點。
get_Text	呼叫這個方法會取得顯示於控制項的文字。
get_Valid	呼叫這個方法會取得表示旗標狀態控制是否有效。
get_Window	呼叫這個方法會取得視窗控制代碼關聯的控制項。與 CStockPropImpl::get_HWND。
put_Appearance	呼叫這個方法會設定控制項，例如，一般或 3D 使用的繪製樣式。
put_AutoSize	呼叫這個方法會設定布林值旗標的值控制是否不可以是其他大小。
put_BackColor	呼叫這個方法會設定控制項的背景色彩。
put_BackStyle	呼叫這個方法會設定控制項的背景樣式。
put_BorderColor	呼叫這個方法會設定控制項的框線色彩。
put_BorderStyle	呼叫這個方法會設定控制項的框線樣式。
put_BorderVisible	呼叫這個方法會設定布林值旗標的值表示控制項的框線是否為可見的。
put_BorderWidth	呼叫這個方法會設定控制項的框線寬度。
put_Caption	呼叫這個方法會設定要顯示的文字和控制項。
put_DrawMode	呼叫這個方法會設定控制項的繪製模式，例如，位元 XOR 筆或反轉色彩。
put_DrawStyle	呼叫這個方法會設定控制項的繪製模式，例如，實線，虛線則為多了。
put_DrawWidth	呼叫這個方法會設定控制項的繪圖方法 (以像素為單位) 使用的寬度。
put_Enabled	呼叫這個方法會設定旗標 (指出控制項是否已啟用。
put_FillColor	呼叫這個方法會設定控制項的填滿色彩。
put_FillStyle	呼叫這個方法會設定控制項的填滿模式，例如，實線，透明或跨平台的縮放繪製。
put_Font	呼叫這個方法會設定控制項的字型屬性。
put_ForeColor	呼叫這個方法會設定控制項的前景色彩。
put_HWND	這個方法會傳回 E_FAIL。
put_MouseIcon	呼叫這個方法會設定 (圖示、點陣圖、中繼檔) 中要顯示的圖片屬性圖形，當滑鼠指標在控制項中。
put_MousePointer	當滑鼠指標在控制項，例如，箭號、十字或沙漏時，呼叫這個方法會設定顯示的滑鼠指標型別。
put_Picture	呼叫這個方法會設定 (圖示、點陣圖、中繼檔) 中要顯示的圖片屬性圖形。
put_ReadyState	呼叫這個方法會設定控制項的就緒狀態，例如，載入或載入。
put_TabStop	呼叫這個方法會設定布林值旗標的值控制是否是定位停駐點。
put_Text	呼叫這個方法會設定顯示於控制項的文字。
put_Valid	呼叫這個方法會設定旗標 (指出控制項是否有效。
put_Window	呼叫這個方法 CStockPropImpl::put_HWND，傳回 E_FAIL。
putref_Font	呼叫這個方法會設定控制項的字型屬性，以參考計數。
putref_MouseIcon	呼叫這個方法會設定要顯示的圖形 (圖示、點陣圖、中繼檔圖片) 的屬性，當滑鼠指標在控制項時，會使用參考計數。
putref_Picture	呼叫這個方法會設定要顯示的圖形 (圖示、點陣圖、中繼檔圖片) 的屬性，以參考計數。

備註

CStockPropImpl 為每個內建屬性提供 put 和 get 方法。在屬性變更時，這些方法所需的程式碼設定或取得資料成員與每個屬性和循環和同步處理與容器。

Visual C++ 提供內建屬性支援透過它的精靈。如需加入內建屬性的詳細資訊加入至控制項，請參閱 ATL 教學課程。

考量到回溯相容性， CStockPropImpl 分別也會公開 get_Window 和呼叫 get_HWND 和 put_HWND的 put_Window 方法。因為 HWND 應該是唯讀屬性， put_HWND 的預設實作會傳回 E_FAIL 。

下列屬性也具有 putref 實作:

• Font

• MouseIcon

• 圖片

相同的三個內建屬性要求其對應的資料成員提供計數透過指派運算子右側介面參考的型別 CComPtr 或其他類別。

繼承階層架構

T

IDispatchImpl

CStockPropImpl

需求

Header: atlctl.h

請參閱

參考

IDispatchImpl 類別

其他資源

ATL 類別概觀