Ogólne informacje o kontrolce
Ta sekcja zawiera informacje referencyjne dotyczące elementów programowania, które mają zastosowanie do wielu kontrolek, a nie tylko do określonej kontrolki. Istnieją funkcje, makra, komunikaty, powiadomienia i struktury, które większość kontrolek obsługuje. Na przykład większość kontrolek używa powiadomień NM_HOVER do przetwarzania kliknięć myszą.
- Przeglądy
- Functions
- makra
- wiadomości
- powiadomień
- struktury
- stałe
Przeglądy
| Temat | Treść |
|---|---|
| o typowych kontrolkach | Typowe kontrolki to zestaw okien implementowanych przez wspólną bibliotekę kontrolek, która jest biblioteką DLL dołączona do systemu operacyjnego Windows. |
| typowe kontrolki — często zadawane pytania | To często zadawane pytania zawiera odpowiedzi na niektóre typowe pytania dotyczące typowych kontrolek. |
Funkcje
| Temat | Treść |
|---|---|
| DoReaderMode | Włącza tryb czytelnika w oknie. |
| DPA_Clone | Duplikuje tablicę wskaźnika dynamicznego (DPA). |
| DPA_Create | Tworzy dpa. |
| DPA_CreateEx | Tworzy dpa przy użyciu określonego rozmiaru i lokalizacji sterty. |
| DPA_DeleteAllPtrs | Usuwa wszystkie elementy z dpa i zmniejsza odpowiednio dpa. |
| DPA_DeletePtr | Usuwa element z dpa. Program DPA zmniejsza się, jeśli jest to konieczne, aby uwzględnić usunięty element. |
| DPA_Destroy | Zwalnia tablicę wskaźników dynamicznych (DPA). |
| DPA_DestroyCallback | Wywołuje pfnCB dla każdego elementu DPA, a następnie zwalnia DPA. |
| DPA_EnumCallback | Iteruje za pośrednictwem tablicy wskaźnika dynamicznego (DPA) i wywołuje pfnCB na każdym elemencie. |
| DPA_GetPtr | Pobiera element z dpa. |
| DPA_GetPtrIndex | Pobiera indeks pasującego elementu znalezionego w dpa. |
| DPA_GetSize | Pobiera rozmiar dpa. |
| DPA_Grow | Zmienia liczbę wskaźników w dpa. |
| DPA_InsertPtr | Wstawia nowy element na określonej pozycji w dpa. W razie potrzeby dpa rozszerza się, aby uwzględnić nowy element. |
| DPA_LoadStream | Ładuje dpa ze strumienia, wywołując określoną funkcję wywołania zwrotnego w celu odczytania każdego elementu. |
| DPA_Merge | Łączy zawartość dwóch agentów DPA. |
| DPA_SaveStream | Zapisuje dpa w strumieniu, zapisując nagłówek, a następnie wywołując określoną funkcję wywołania zwrotnego w celu zapisania każdego elementu. |
| DPA_Search | Znajduje element w dpa. |
| DPA_SetPtr | Przypisuje wartość do elementu w dpa. |
| DPA_Sort | Sortuje elementy w tablicy wskaźników dynamicznych (DPA). |
| DrawShadowText | Rysuje tekst, który ma cień. |
| DrawTextExPrivWrap | Rysuje sformatowany tekst w określonym prostokątze. Ta funkcja opakowuje wywołanie DrawTextEx. |
| DrawTextWrap | Rysuje sformatowany tekst w określonym prostokątze. Formatuje tekst zgodnie z określoną metodą (rozwijanie kart, uzasadnianie znaków, wierszy przerwania itd.). Ta funkcja opakowuje wywołanie metody DrawText. |
| DSA_Clone | Duplikuje tablicę struktury dynamicznej (DSA). |
| DSA_Create | Tworzy dsa dsa. |
| DSA_DeleteAllItems | Usuwa wszystkie elementy z dsa. |
| DSA_DeleteItem | Usuwa element z dsa. |
| DSA_Destroy | Zwalnia DSA. |
| DSA_DestroyCallback | Iteruje za pośrednictwem dsA, wywołując określoną funkcję wywołania zwrotnego w każdym elemencie. Po osiągnięciu końca tablicy podmiot dsa jest zwalniany. |
| DSA_EnumCallback | Iteruje za pośrednictwem DSA i wywołuje pfnCB na każdym elemencie. |
| DSA_GetItem | Pobiera element z dsa. |
| DSA_GetItemPtr | Pobiera wskaźnik do elementu z dsa. |
| DSA_GetSize | Pobiera rozmiar dsa. |
| DSA_InsertItem | Wstawia nowy element do dsa. W razie potrzeby rozszerzenie DSA zostanie rozwinięte, aby uwzględnić nowy element. |
| DSA_SetItem | Ustawia zawartość elementu w dsa. |
| DSA_Sort | Sortuje elementy w usłudze DSA. |
| ExtTextOutWrap | Rysuje tekst przy użyciu aktualnie zaznaczonej czcionki, koloru tła i koloru tekstu. Opcjonalnie można podać wymiary, które mają być używane do wycinków, nieprzezroczystości lub obu tych elementów. Ta funkcja opakowuje wywołanie ExtTextOut. |
| GetEffectiveClientRect | Oblicza wymiary prostokąta w obszarze klienta, który zawiera wszystkie określone kontrolki. |
| GetMUILanguage | Pobiera język używany obecnie przez typowe kontrolki dla określonego procesu. |
| GetTextExtentPoint32Wrap | Oblicza szerokość i wysokość określonego ciągu tekstu. Ta funkcja opakowuje wywołanie polecenia GetTextExtentPoint. |
| InitCommonControls | Rejestruje i inicjuje niektóre typowe klasy okien sterowania. Ta funkcja jest przestarzała. Nowe aplikacje powinny używać funkcji InitCommonControlsEx. |
| InitCommonControlsEx | Rejestruje określone typowe klasy kontrolek z biblioteki DLL wspólnej kontrolki. |
| InitMUILanguage | Umożliwia aplikacji określenie języka, który ma być używany z typowymi kontrolkami, które różnią się od języka systemowego. |
| LoadIconMetric | Ładuje określony zasób ikony z metryką systemu określoną przez klienta. |
| LoadIconWithScaleDown | Ładuje ikonę. Jeśli ikona nie jest standardowym rozmiarem, ta funkcja skaluje w dół większy obraz zamiast skalowania w górę mniejszego obrazu. |
| MirrorIcon | Odwróć (dublowane) ikony, aby były one wyświetlane poprawnie w kontekście urządzenia dublowanego. |
| PFNDACOMPARE | Definiuje prototyp funkcji compare używanej przez DSA_Sort. |
| PFNDACOMPARECONST | Definiuje prototyp funkcji compare używanej przez DSA_Sort, gdy porównywane elementy są obiektami stałymi. |
| PFNDAENUMCALLBACK | Definiuje prototyp funkcji wywołania zwrotnego używanej przez funkcje DSA i DPA. |
| PFNDAENUMCALLBACKCONST | Definiuje prototyp funkcji wywołania zwrotnego używanej przez funkcje DSA i DPA, gdy zaangażowane elementy są wskaźnikami do stałych danych. |
| PFNDPACOMPARE | Definiuje prototyp funkcji compare używanej przez DPA_Sort i DPA_Search. |
| PFNDPACOMPARECONST | Definiuje prototyp funkcji compare używanej przez DPA_Sort lub DPA_Search, gdy porównywane elementy są obiektami stałymi. |
| PFNDPAENUMCALLBACK | Definiuje prototyp funkcji wywołania zwrotnego używanej przez DPA_EnumCallback. |
| PFNDPAMERGE | Definiuje prototyp funkcji scalania używanej przez DPA_Merge. |
| PFNDPAMERGECONST | Definiuje prototyp funkcji scalania używanej przez DPA_Merge, używając wartości stałych. |
| PFNDPASTREAM | Definiuje prototyp funkcji wywołania zwrotnego używanej przez DPA_LoadStream i DPA_SaveStream. |
| PFNDSAENUMCALLBACK | Definiuje prototyp funkcji wywołania zwrotnego używanej przez DSA_DestroyCallback. |
| ReaderScroll | Funkcja wywołania zwrotnego zdefiniowana przez aplikację używana podczas przenoszenia wskaźnika myszy w części okna trybu czytnika, które zostało zadeklarowane jako aktywny obszar przewijania. |
| ShowHideMenuCtl | Ustawia lub usuwa atrybut znacznika wyboru określonego elementu menu i pokazuje lub ukrywa odpowiednią kontrolkę. Funkcja dodaje znacznik wyboru do określonego elementu menu, jeśli nie ma go, a następnie wyświetla odpowiednią kontrolkę. Jeśli element menu ma już znacznik wyboru, funkcja usuwa znacznik wyboru i ukrywa odpowiednią kontrolkę. |
| Str_GetPtr | Kopiuje ciąg z jednego buforu do innego. |
| Str_SetPtrW | Ustawia ppszCurrent do kopii pszNew i zwalnia poprzednią wartość w razie potrzeby. |
| TranslateDispatch | Używany przez klienta funkcji DoReaderMode do przechwytywania i jawnego obsługi wszystkich komunikatów systemu Windows przeznaczonych dla obszaru przewijania okna trybu czytnika. Jest to funkcja wywołania zwrotnego zdefiniowana przez aplikację. |
Makra
| Temat | Treść |
|---|---|
| DPA_AppendPtr | Wstawia nowy element na końcu dpa. |
| DPA_FastDeleteLastPtr | Usuwa ostatni wskaźnik z dpa. |
| DPA_FastGetPtr | Pobiera wartość określonego wskaźnika w dpa. |
| DPA_GetPtrCount | Pobiera liczbę wskaźników w dpa. |
| DPA_GetPtrPtr | Pobiera wskaźnik do wewnętrznej tablicy wskaźników DPA. |
| DPA_SetPtrCount | Ustawia liczbę wskaźników w dpa. |
| DPA_SortedInsertPtr | Wstawia nowy element przed lub po określonym istniejącym elemencie. |
| DSA_AppendItem | Dołącza nowy element na końcu dsa. |
| DSA_GetItemCount | Pobiera liczbę elementów w dsa. |
| FORWARD_WM_NOTIFY | Wysyła lub publikuje wiadomość WM_NOTIFY. |
| HANDLE_WM_NOTIFY | Wywołuje funkcję przetwarzającą komunikat WM_NOTIFY. |
| INDEXTOSTATEIMAGEMASK | Przygotowuje indeks obrazu stanu, aby kontrolka widoku drzewa lub kontrolka widoku listy mogła użyć indeksu do pobrania obrazu stanu dla elementu. |
Wiadomości
| Temat | Treść |
|---|---|
| CCM_DPISCALE | Umożliwia automatyczne skalowanie o dużej wartości kropek na cal (dpi) w kontrolkach Tree-View, List-View kontrolki, kontrolki comboBoxEx , kontrolki nagłówka , przyciski , kontrolki paska narzędzi, kontrolki animacji i list obrazów. |
| CCM_GETUNICODEFORMAT | Pobiera flagę formatu znaków Unicode dla kontrolki. |
| CCM_GETVERSION | Pobiera numer wersji kontrolki ustawionej przez najnowszy komunikat CCM_SETVERSION. |
| CCM_SETUNICODEFORMAT | Ustawia flagę formatu znaków Unicode dla kontrolki. Ten komunikat umożliwia zmianę zestawu znaków używanego przez kontrolkę w czasie wykonywania, a nie konieczności ponownego tworzenia kontrolki. |
| CCM_SETVERSION | Ten komunikat służy do informowania kontrolki o oczekiwanym zachowaniu skojarzonym z określoną wersją. |
| CCM_SETWINDOWTHEME | Ustawia styl wizualizacji kontrolki. |
| WM_NOTIFY | Wysłane przez wspólną kontrolkę do okna nadrzędnego, gdy wystąpiło zdarzenie lub kontrolka wymaga pewnych informacji. |
| WM_NOTIFYFORMAT | Określa, czy okno akceptuje struktury ANSI lub Unicode w komunikacie powiadomienia WM_NOTIFY.
WM_NOTIFYFORMAT komunikaty są wysyłane ze wspólnej kontrolki do okna nadrzędnego i z okna nadrzędnego do wspólnej kontrolki. |
Powiadomienia
| Temat | Treść |
|---|---|
| NM_CHAR | Kod powiadomienia NM_CHAR jest wysyłany przez kontrolkę po przetworzeniu klucza znaku. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_CUSTOMDRAW | Powiadamia okno nadrzędne kontrolki o niestandardowych operacjach rysowania. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_CUSTOMTEXT | Powiadamia okno nadrzędne kontrolki o niestandardowych operacjach tekstowych. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_FONTCHANGED | Wysłane przez kontrolkę widoku listy, gdy kontrolka zmieniła czcionkę. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_GETCUSTOMSPLITRECT | Wysłane przez kontrolkę przycisku do elementu nadrzędnego w celu uzyskania pomiarów dla dwóch prostokątów tworzących przycisk podziału. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_HOVER | Wysłane przez kontrolkę po umieszczeniu wskaźnika myszy na elemencie. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_KEYDOWN | Wysyłane przez kontrolkę, gdy kontrolka ma fokus klawiatury, a użytkownik naciska. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_KILLFOCUS | Powiadamia okno nadrzędne kontrolki, że kontrolka straciła fokus wejściowy. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_LDOWN | Powiadamia okno nadrzędne kontrolki o naciśnięciu lewego przycisku myszy. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_NCHITTEST | Wysyłane przez kontrolkę paska pomocniczego, gdy kontrolka odbiera komunikat WM_NCHITTEST. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_OUTOFMEMORY | Powiadamia okno nadrzędne kontrolki, że kontrolka nie mogła ukończyć operacji, ponieważ nie było wystarczającej ilości dostępnej pamięci. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_RDOWN | Obecnie nieobsługiwane. |
| NM_RELEASEDCAPTURE | Powiadamia okno nadrzędne kontrolki, że kontrolka zwalnia przechwytywanie myszy. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_RETURN | Powiadamia okno nadrzędne kontrolki, że kontrolka ma fokus wejściowy i że użytkownik nacisnął ENTER. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_SETCURSOR | Powiadamia okno nadrzędne kontrolki, że kontrolka ustawia kursor w odpowiedzi na komunikat NM_SETCURSOR. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_SETFOCUS | Powiadamia okno nadrzędne kontrolki, że kontrolka otrzymała fokus wejściowy. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_THEMECHANGED | Powiadamia okno nadrzędne kontrolki o zmianie motywu. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_TOOLTIPSCREATED | Powiadamia okno nadrzędne kontrolki, że kontrolka utworzyła kontrolkę etykietki narzędzia. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
| NM_TVSTATEIMAGECHANGING | Wysłane przez kontrolkę widoku drzewa do okna nadrzędnego, które zmienia obraz stanu. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. |
Struktur
| Temat | Treść |
|---|---|
| COLORSCHEME | Zawiera informacje dotyczące rysowania przycisków na pasku narzędzi lub pasku nawigacyjnym. |
| DPASTREAMINFO | Zawiera element strumienia używany przez funkcję PFNDPASTREAM wywołania zwrotnego. |
| INITCOMMONCONTROLSEX | Zawiera informacje używane do ładowania typowych klas kontrolek z biblioteki dynamic-link (DLL). Ta struktura jest używana z funkcją InitCommonControlsEx. |
| NMCHAR | Zawiera informacje używane z komunikatami powiadomień o znakach. |
| NMCUSTOMSPLITRECTINFO | Zawiera informacje o dwóch prostokątach przycisku podziału. Wysłane za pomocą powiadomienia NM_GETCUSTOMSPLITRECT. |
| NMCUSTOMTEXT | Zawiera informacje używane z niestandardowym powiadomieniem tekstowymi. |
| NMHDR | Zawiera informacje o wiadomości z powiadomieniem. |
| NMKEY | Zawiera informacje używane z kluczowymi komunikatami powiadomień. |
| NMMOUSE | Zawiera informacje używane z komunikatami powiadomień myszy. |
| NMOBJECTNOTIFY | Zawiera informacje używane z kodami powiadomień TBN_GETOBJECT, TCN_GETOBJECTi PSN_GETOBJECT. |
| NMTOOLTIPSCREATED | Zawiera informacje używane z kodem powiadomień NM_TOOLTIPSCREATED. |
| READERMODEINFO | Zawiera informacje wymagane do zainicjowania funkcji DoReaderMode. |
Stałe
| Temat | Treść |
|---|---|
| stałe CDRF | Te stałe są używane jako wartości zwracane przez kontrolkę w odpowiedzi na kod powiadomienia NM_CUSTOMDRAW. |
| stylów | W tej sekcji wymieniono typowe style kontrolek. Z wyjątkiem przypadków, w których zanotowano, te style dotyczą kontrolek nagłówka, kontrolek paska narzędzi i okien stanu. |
| klas okien | Ta sekcja zawiera listę nazw klas okien udostępnianych przez wspólną bibliotekę kontrolek. |