CMenu::SetMenuItemBitmaps

Artykuł
02/27/2013

Kojarzy określonego bitmapy z elementu menu.

BOOL SetMenuItemBitmaps(
   UINT nPosition,
   UINT nFlags,
   const CBitmap* pBmpUnchecked,
   const CBitmap* pBmpChecked 
);

Parametry

nPosition
Określa element menu ma zostać zmieniony.nFlags Parametru można interpretować nPosition w następujący sposób:

nFlags	Interpretacja nPosition
MF_BYCOMMAND	Określa, że parametr podaje identyfikator polecenia istniejący element menu.Jest to wartość domyślna, jeśli żadna MF_BYCOMMAND ani MF_BYPOSITION jest ustawiona.
MF_BYPOSITION	Określa, że parametr podaje położenie istniejący element menu.Pierwszy element jest w położeniu 0.

nFlags
Określa, jak nPosition jest interpretowane.
pBmpUnchecked
Określa mapę bitową dla elementów menu, które nie są sprawdzane.
pBmpChecked
Określa mapę bitową dla elementów menu, które są sprawdzane.

Wartość zwracana

Niezerowa, jeśli funkcja jest pomyślne; 0 inaczej.

Uwagi

Czy element menu jest zaznaczony lub niezaznaczony, Windows wyświetla odpowiednią mapę bitową obok elementu menu.

Jeśli pBmpUnchecked lub pBmpChecked jest NULL, a następnie system Windows wyświetla nic obok elementu menu dla atrybutu.Jeśli oba parametry są NULL, gdy element jest sprawdzany i usunięcie znacznika wyboru, gdy element jest zaznaczone, system Windows używa domyślny znacznik wyboru.

Gdy menu jest niszczony, bitmapy te nie są zniszczone; wniosek należy zniszczyć.

Windows GetMenuCheckMarkDimensions funkcja pobiera wymiary domyślne znacznik wyboru, stosowane dla elementów menu.Aplikacja używa tych wartości, aby określić odpowiedni rozmiar bitmapy, dostarczane z tej funkcji.Uzyskać rozmiaru, tworzenia sieci bitmapy, a następnie ustaw je.

Przykład

// The code fragment below is from CMainFrame::OnCreate and shows 
// how to associate bitmaps with the "Bitmap" menu item. 
// Whether the "Bitmap" menu item is checked or unchecked, Windows 
// displays the appropriate bitmap next to the menu item. Both 
// IDB_CHECKBITMAP and IDB_UNCHECKBITMAP bitmaps are loaded 
// in OnCreate() and destroyed in the destructor of CMainFrame class. 
// CMainFrame is a CFrameWnd-derived class.

// Load bitmaps from resource. Both m_CheckBitmap and m_UnCheckBitmap
// are member variables of CMainFrame class of type CBitmap.
ASSERT(m_CheckBitmap.LoadBitmap(IDB_CHECKBITMAP));
ASSERT(m_UnCheckBitmap.LoadBitmap(IDB_UNCHECKBITMAP));

// Associate bitmaps with the "Bitmap" menu item. 
CMenu* mmenu = GetMenu();
CMenu* submenu = mmenu->GetSubMenu(4);
ASSERT(submenu->SetMenuItemBitmaps(ID_MENU_BITMAP, MF_BYCOMMAND, 
   &m_CheckBitmap, &m_UnCheckBitmap));

// This code fragment is taken from CMainFrame::~CMainFrame

// Destroy the bitmap objects if they are loaded successfully 
// in OnCreate().
if (m_CheckBitmap.m_hObject)
   m_CheckBitmap.DeleteObject();

if (m_UnCheckBitmap.m_hObject)
   m_UnCheckBitmap.DeleteObject();