Udostępnij przez

Właściwości standardowe

Obiekt OLE definiuje zestaw standardowych identyfikatorów DISPID dla wszystkich trzech rodzajów właściwości: kontrolki, otoczenia i rozszerzonego. W poniższych tabelach wymieniono te standardy dotyczące właściwości kontrolek, właściwości otoczenia i właściwości rozszerzonych.

Właściwość kontrolki Typ Opis
BackColor, ForeColor, FillColor, BorderColor
 OLE_COLOR
 Schemat kolorów kontrolki
BackStyle, FillStyle, BorderStyle, BorderWidth, BorderVisible, DrawStyle, DrawWidth
 krótkie lub długie
 Bity definiujące zachowanie wizualne kontrolki, takie jak stałe lub przezroczyste, o grubych lub cienkich obramowaniach, stylach linii itd.
Czcionka
 IDispatch *
 Czcionka używana w kontrolce, która jest wskaźnikiem IDispatch do standardowego obiektu czcionki. Aby uzyskać więcej informacji, zobacz Standard Font Object.
Podpis, tekst
 BSTR
 Ciągi zawierające etykietę kontrolki (podpis) lub jej zawartość tekstową (tekst). Należy pamiętać, że podpis nie musi określać kontrolki w kontenerze. Zobacz właściwość extended Name w poniższej tabeli.
Włączone
 BOOL
 Określa, czy kontrolka jest włączona, czy wyłączona. Jeśli ta kontrolka jest wyłączona, prawdopodobnie jest szara.
Okno
 HWND
 Uchwyt okna kontrolki, jeśli ma go.
Tabstop
 BOOL
 Określa, czy ta kontrolka jest zatrzymaniem karty.
Właściwość otoczenia Typ Opis
BackColor, ForeColor
 OLE_COLOR
 Udostępnia kontrolki z domyślnym tłem i kolorami pierwszego planu. Użycie przez kontrolkę jest opcjonalne.
Czcionka
 IDispatch *
 Wskaźnik do standardowego obiektu czcionki, który definiuje domyślną czcionkę formularza. Użycie przez kontrolkę jest opcjonalne. Aby uzyskać więcej informacji, zobacz Standard Font Object.
Identyfikator ustawień regionalnych
 LCID
 Język używany w kontenerze. Zalecane jest użycie przez kontrolkę.
UserMode
 BOOL
 Opisuje, czy kontener jest w trybie projektowania (false) lub w trybie uruchamiania (TRUE), którego kontrolka powinna używać do zmiany jego dostępnej funkcjonalności w razie potrzeby.
UIDead
 BOOL
 Opisuje, czy kontener jest w trybie, w którym kontrolki powinny ignorować dane wejściowe użytkownika. Dotyczy to niezależnie od elementu UserMode. Kontener może zawsze ustawiać wartość UIDead na true w trybie projektowania i może ustawić dla niego wartość TRUE po osiągnięciu punktu przerwania lub takiego w trybie uruchamiania. Kontrolka musi zwrócić uwagę na tę właściwość.
MessageReflect
 BOOL
 Określa, czy kontener chce odbierać komunikaty systemu Windows, takie jak WM_CTLCOLOR, WM_DRAWITEM, WM_PARENTNOTIFY i tak dalej jak zdarzenia.
Obsługa Mnemonics
 BOOL
 Opisuje, czy kontener przetwarza mnemonics, czy nie. Kontrolka może robić wszystko, czego chce, korzystając z tych informacji, takich jak znaki nie podkreślonego, które zwykle będą używane jako mnemonic.
ShowGrabHandles, ShowHatching
 BOOL
 Opisuje, czy kontrolka powinna pokazywać obramowanie kreskowania lub chwytać uchwyty (na obramowanie kreskowania) w przypadku aktywnego miejsca. Kontrolki muszą przestrzegać tych właściwości, dając kontenerowi ostateczną kontrolę nad tym, kto faktycznie pobiera te bity interfejsu użytkownika. Kontener sterowania może chcieć rysować własne zamiast polegać na każdej kontrolce, w tym przypadku te otoczenia zawsze będą FALSE.
DisplayAsDefault
 BOOL
 Kontener uwidacznia true dla tej właściwości za pośrednictwem dowolnej witryny zawierającej to, co jest oznaczone jako przycisk domyślny, gdy kontrolka przycisku powinna rysować się grubszą ramką domyślną.
Właściwość rozszerzona Typ Opis
Nazwa
 BSTR
 Nazwa kontenera dla kontrolki.
Widoczny
 BOOL
 Widoczność kontrolki.
Rodzic
 IDispatch *
 Dispinterface formularza zawierającego kontrolkę.
Ustawienie domyślne, Anuluj
 BOOL
 Wskazuje, czy ta kontrolka jest domyślnym przyciskiem lub anuluj.

Wszystkie te właściwości standardowe mają ujemne wartości DISPID wskazujące ich stan standardowy.

Należy pamiętać, że aby uniknąć konfliktów w symbolach programowych dla tych identyfikatorów DISPID, wszystkie właściwości otoczenia mają symbole w postaci DISPID_AMBIENT_właściwości jak w DISPID_AMBIENT_FORECOLOR. Wszystkie inne symbole używają właściwości DISPID_ jak zwykle.

Niektóre właściwości otoczenia, a także właściwości kontrolki, obejmują kolory. Typ OLE_COLOR wymieniony w poprzednich tabelach może odwoływać się do standardowego typu COLORREF, indeksu palety, indeksu względnego palety lub indeksu kolorów systemu używanego z funkcją GetSysColor. Funkcja OleTranslateColor konwertuje typ OLE_COLOR na typ COLORREF dla danej palety.

właściwości kontrolki

  • Last updated on