SetMenuItemBitmaps

Funkcja SetMenuItemBitmaps kojarzy Podana mapa bitowa z elementu menu. Czy element menu jest zaznaczony lub niezaznaczony, system wyświetla odpowiednią mapę bitową obok elementu menu.

(BOOL SetMenuItemBitmaps HMENU  hMenu, / / obsługi menuUINTuPosition, / / elementu menu, aby otrzymać nowe mapy bitoweUINTuFlags, / / flags elementu menuHBITMAPhBitmapUnchecked, / / dojście do niezaznaczone bitmapyHBITMAPhBitmapChecked / / uchwyt sprawdzone bitmapę);
 

Parametry

hMenu
Dojście do menu zawierający element, który ma otrzymać nowy znacznik wyboru mapy bitowe.
uPosition
Określa element menu ma być zmieniona, określone przez parametr uFlags.
uFlags
Określa, w jaki sposób interpretowane parametr uPosition . Parametr uFlags musi to być jedna z następujących wartości.
Wartość Znaczenie
MF_BYCOMMAND Wskazuje, że ten uPosition podaje identyfikator elementu menu. Jeżeli określono wartość MF_BYCOMMAND ani MF_BYPOSITION, MF_BYCOMMAND jest flagę domyślną.
MF_BYPOSITION Wskazuje, że ten uPosition daje od zera względne położenie elementu menu.

hBitmapUnchecked
Uchwyt do mapy bitowej wyświetlany, gdy element menu nie jest zaznaczone.
hBitmapChecked
Dojście do mapy bitowej wyświetlany, gdy element menu jest sprawdzana.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Jeśli parametr hBitmapUnchecked lub hBitmapChecked ma wartość NULL, system wyświetla niczego obok elementu menu dla odpowiedniego stanu zaznaczenia. Jeśli oba parametry są wartości NULL, system wyświetla domyślną mapę bitową znacznik wyboru, jeśli element jest zaznaczony i usuwa bitmapy, gdy element nie jest zaznaczony.

Tych bitmap nie są niszczony, kiedy niszczony jest menu, jest do stosowania w celu ich zniszczenia.

Bitmapy zaznaczone, jak i niezaznaczone powinny być czarno-białych. System używa operatora logiczna i połączyć bitmapy z menu, tak aby Biała część staje się przezroczyste, a czarny część staje się kolor elementu menu. Jeśli używasz kolorowe, wyniki mogą być niepożądane.

Należy stosować funkcję GetSystemMetrics z wartości CXMENUCHECK i CYMENUCHECK do pobrania wymiary bitmapy.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Menu omówienie, Funkcje Menu, GetSystemMetrics

Index