Standardní vlastnosti
OLE definuje sadu standardních identifikátorů DISPID pro všechny tři druhy vlastností: ovládací prvek, okolí a rozšířené. Následující tabulky uvádějí tyto standardy pro vlastnosti ovládacího prvku, okolní vlastnosti a rozšířené vlastnosti.
| Vlastnost ovládacího prvku | Typ | Popis |
|---|---|---|
| BackColor, ForeColor, FillColor, BorderColor |
OLE_COLOR |
Barevné schéma ovládacího prvku |
| BackStyle, FillStyle, BorderStyle, BorderWidth, BorderVisible, DrawStyle, DrawWidth |
krátké nebo dlouhé |
Bity, které definují vizuální chování ovládacího prvku, jako je pevná nebo průhledná, mají silné nebo tenké ohraničení, styly čar atd. |
| Písmo |
IDispatch * |
Písmo použité v ovládacím prvku, což je IDispatch ukazatel na standardní objekt písma. Další informace najdete v tématu Standardní objekt písma. |
| Titulek, text |
BSTR |
Řetězce obsahující popisek ovládacího prvku (titulek) nebo jeho textový obsah (text). Všimněte si, že titulek nemusí nutně pojmenovat ovládací prvek v kontejneru. Podívejte se na vlastnost extended Name v následující tabulce. |
| Zpřístupněný |
BOOL |
Určuje, zda je ovládací prvek povolený nebo zakázaný. Pokud je tento ovládací prvek zakázaný, pravděpodobně se zobrazí šedě. |
| Okno |
HWND |
Popisovač okna ovládacího prvku, pokud ho má. |
| Tabstop |
BOOL |
Určuje, zda je tento ovládací prvek zarážkou tabulátoru. |
| Ambient – vlastnost | Typ | Popis |
|---|---|---|
| BackColor, ForeColor |
OLE_COLOR |
Poskytuje ovládací prvky s výchozími barvami pozadí a popředí. Použití ovládacím prvku je volitelné. |
| Písmo |
IDispatch * |
Ukazatel na standardní objekt písma, který definuje výchozí písmo formuláře. Použití ovládacím prvku je volitelné. Další informace najdete v tématu Standardní objekt písma. |
| ID národního prostředí |
LCID |
Jazyk použitý v kontejneru. Doporučuje se použít ovládací prvek. |
| UserMode |
BOOL |
Popisuje, jestli je kontejner v režimu návrhu (FALSE) nebo v režimu spuštění (TRUE), který by měl ovládací prvek použít ke změně jeho dostupné funkce podle potřeby. |
| UIDead |
BOOL |
Popisuje, jestli je kontejner v režimu, ve kterém by ovládací prvky měly ignorovat uživatelský vstup. To platí bez ohledu na userMode. Kontejner může vždy nastavit UIDead na TRUE v režimu návrhu a může ho nastavit na TRUE, pokud dojde k zarážce nebo takové zarážce během režimu spuštění. Ovládací prvek musí věnovat pozornost této vlastnosti. |
| MessageReflect |
BOOL |
Určuje, jestli má kontejner přijímat zprávy systému Windows, jako jsou WM_CTLCOLOR, WM_DRAWITEM, WM_PARENTNOTIFY atd. jako události. |
| SupportsMnemonics |
BOOL |
Popisuje, jestli kontejner zpracovává mnemonics, nebo ne. Ovládací prvek může s těmito informacemi dělat cokoli, například nepodtržení znaků, které by normálně používal jako mnemonic. |
| ShowGrabHandles, ShowHatching |
BOOL |
Popisuje, jestli má ovládací prvek při aktivním místě zobrazit šrafované ohraničení nebo úchyty (na okraji šrafování). Ovládací prvky musí tyto vlastnosti dodržovat, což dává kontejneru konečnou kontrolu nad tím, kdo skutečně nakreslí tyto bity uživatelského rozhraní. Kontejner ovládacího prvku může chtít nakreslit vlastní místo spoléhání na každý ovládací prvek, v takovém případě budou tyto okolí vždy FALSE. |
| DisplayAsDefault |
BOOL |
Kontejner zpřístupní TRUE pro tuto vlastnost prostřednictvím libovolného webu obsahuje to, co je označeno jako výchozí tlačítko, když by se ovládací prvek tlačítka měl nakreslit silnějším výchozím rámečkem. |
| Rozšířená vlastnost | Typ | Popis |
|---|---|---|
| Jméno |
BSTR |
Název kontejneru pro ovládací prvek. |
| Viditelný |
BOOL |
Viditelnost ovládacího prvku. |
| Rodič |
IDispatch * |
Dispinterface formuláře obsahujícího ovládací prvek. |
| Výchozí, Zrušit |
BOOL |
Označuje, jestli je tento ovládací prvek výchozím tlačítkem nebo tlačítko zrušit. |
Všechny tyto standardní vlastnosti mají záporné hodnoty DISPID označující jejich standardní stav.
Všimněte si, že chcete-li zabránit konfliktům v programových symbolech pro tyto identifikátory DISPID, všechny okolní vlastnosti jsou uvedeny symboly ve formuláři DISPID_AMBIENT_vlastnost jako v DISPID_AMBIENT_FORECOLOR. Všechny ostatní symboly používají DISPID_vlastnost jako obvykle.
Některé okolní vlastnosti, stejně jako vlastnosti ovládacího prvku, zahrnují barvy. Typ OLE_COLOR uvedený v předchozích tabulkách může odkazovat na standardní typ COLORREF, index palety, index indexu relativního indexu palety nebo index barvy systému, který se používá s funkcí GetSysColor. Funkce OleTranslateColor převede typ OLE_COLOR na typ COLORREF typu dané palety.