COleControl::GetAmbientProperty

發行項
02/28/2013

取得容器中的環境屬性的值。

BOOL GetAmbientProperty(
   DISPID dispid,
   VARTYPE vtProp,
   void* pvProp 
);

參數

dwDispid
所需的環境屬性的分派 ID。
vtProp
指定在 pvProp要傳回的值型別的 Variant 型別標記。

pvProp
要接收屬性值或傳回值之變數的位址指標。這個指標的實際型別必須符合 vtProp所指定的型別。

vtProp	pvProp 的型別
VT_BOOL	BOOL*
VT_BSTR	CString*
VT_I2	short*
VT_I4	long*
VT_R4	float*
VT_R8	double*
VT_CY	CY*
VT_COLOR	OLE_COLOR*
VT_DISPATCH	LPDISPATCH*
VT_FONT	LPFONTDISP*

傳回值

如果不是零，則環境屬性支援，則為 0。

備註

如果您使用 GetAmbientProperty 擷取環境 ScaleUnits DisplayName 和屬性，設定為 vtPropVT_BSTR 和 pvProp 至 CString*。如果您擷取環境字型屬性，設定為 vtPropVT_FONT 和 pvProp 至 LPFONTDISP*。

請注意函式提供通用環境屬性已經提供了，例如 AmbientBackColor 和 AmbientFont。