CMenu::SetMenuItemBitmaps

Článek
03/04/2013

Přidruží zadanou bitmapy položky nabídky.

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

Parametry

nPosition
Určuje položku nabídky, který chcete změnit. nFlags Parametru lze interpretovat nPosition následujícími způsoby:

nFlags	Výklad nPosition
MF_BYCOMMAND	Určuje, že parametr poskytuje ID příkazu existující položky nabídky.Toto je výchozí, pokud ani MF_BYCOMMAND ani MF_BYPOSITION je nastavena.
MF_BYPOSITION	Určuje, že parametr dává pozice existující položku nabídky.První položka je na pozici 0.

nFlags
Určuje, jak nPosition je interpretován.
pBmpUnchecked
Určuje rastrový obrázek pro položky nabídky, které nejsou kontrolovány.
pBmpChecked
Určuje rastrový obrázek pro položky nabídky, které jsou kontrolovány.

Vrácená hodnota

Nenulová hodnota, pokud je tato funkce úspěšná. jinak 0.

Poznámky

Zda je položka zaškrtnuté nebo nezaškrtnuté, systém Windows zobrazí příslušný rastrový obrázek vedle položky nabídky.

Pokud pBmpUnchecked nebo pBmpChecked je NULL, pak systém Windows zobrazí nic vedle položky nabídky pro odpovídající atribut.Pokud jsou oba parametry NULL, používá systém Windows výchozí zaškrtnutí položky zaškrtnuto a odstraní zaškrtnutí, pokud zboží není zaškrtnuto.

Při nabídce zničení, tyto bitmapy nejsou zničeny; aplikace musí zničit.

Windows GetMenuCheckMarkDimensions funkce načte výchozí zaškrtnutí položky nabídky pro rozměry.Aplikace používá k určení velikosti vhodné pro bitmapy dodané se tato funkce těchto hodnot.Získat velikost, vytvořit své bitmapy a potom nastavit.

Příklad

// 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();