標準屬性
OLE 會針對這三種屬性定義一組標準 DISPID:控件、環境及擴充。 下表列出控件屬性、環境屬性和擴充屬性的這些標準。
控制項屬性 | 類型 | 描述 |
---|---|---|
BackColor、ForeColor、FillColor、BorderColor |
OLE_COLOR |
控制件的色彩配置 |
BackStyle、FillStyle、BorderStyle、BorderWidth、BorderVisible、DrawStyle、DrawWidth |
短 或 長 |
定義控件視覺行為的位,例如實心或透明、粗細框線、線條樣式等等。 |
字型 |
IDispatch * |
控件中使用的字型,這是 標準字型物件的 IDispatch 指標。 如需詳細資訊,請參閱 標準字型物件 。 |
標題、文字 |
BSTR |
字串,包含控件的標籤(標題)或其文字內容(文字)。 請注意,標題 不一定為容器中的控件命名。 請參閱下表中的擴充 Name 屬性。 |
已啟用 |
BOOL |
判斷控件是啟用還是停用。 如果停用,控件可能呈現灰色。 |
Window |
HWND |
如果控制元件有視窗句柄,則為 。 |
TabStop |
BOOL |
判斷此控制項是否為製表位。 |
Ambient 屬性 | 類型 | 描述 |
---|---|---|
BackColor、ForeColor |
OLE_COLOR |
提供預設背景和前景色彩的控制件。 控制件的使用是選擇性的。 |
字型 |
IDispatch * |
定義表單預設字型之標準字型物件的指標。 控制件的使用是選擇性的。 如需詳細資訊,請參閱 標準字型物件 。 |
LocaleID |
LCID |
容器中使用的語言。 建議使用控件。 |
UserMode |
BOOL |
描述容器是否處於設計模式 (FALSE) 或執行模式 (TRUE),控件應該視需要使用它來變更其可用的功能。 |
UIDead |
BOOL |
描述容器是否處於控件應該忽略使用者輸入的模式。 不論UserMode為何,這都適用。 容器在設計模式中可能一律將UIDead設定為TRUE,而且在執行模式期間遇到斷點時,可能會將它設定為TRUE。 控件必須注意這個屬性。 |
訊息 反思 |
BOOL |
指定容器是否要接收 Windows 訊息,例如WM_CTLCOLOR、WM_DRAWITEM、WM_PARENTNOTIFY等事件。 |
SupportsMnemonics |
BOOL |
描述容器是否處理助記鍵。 控件可以使用這項資訊執行任何想要的動作,例如,它通常用來做為助記鍵的底線字元。 |
ShowGrabHandles、ShowHatching |
BOOL |
描述控制件在就地作用中時,是否應該顯示影線框線或抓取控點(在艙口框線中)。 控件必須遵守這些屬性,讓容器最終控制實際繪製這些使用者介面位的人員。 控件容器可能會想要繪製自己的控件,而不是依賴每個控件,在此情況下,這些環境一律為 FALSE。 |
DisplayAsDefault |
BOOL |
當按鈕控制項應該使用較厚的預設框架繪製本身時,容器會透過任何網站公開 此屬性的 TRUE 。 |
Extended 屬性 | 類型 | Description |
---|---|---|
Name |
BSTR |
控制件的容器名稱。 |
可見 |
BOOL |
控件的可見性。 |
上層 |
IDispatch * |
包含控件之表單的 dispinterface。 |
預設值、取消 |
BOOL |
指出此控制項是否為預設或取消按鈕。 |
所有這些標準屬性都有負的 DISPID 值,表示其標準狀態。
請注意,為了避免這些 DISPID 的程式設計符號發生衝突,所有環境屬性都會以格式指定符號DISPID_AMBIENT_屬性 ,如同在 DISPID_AMBIENT_FORECOLOR 中一樣。 所有其他符號都會像往常一樣使用DISPID_屬性 。
某些環境屬性以及控件屬性涉及色彩。 上 一個數據表中所提及的 OLE_COLOR類型可以參考標準 COLORREF 類型、調色盤的索引、調色盤相對索引,或搭配 GetSysColor 函式使用的系統色彩索引。 OleTranslateColor 函式會將OLE_COLOR類型轉換成指定調色盤的 COLORREF 類型。