Poznámka
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Tato část popisuje nabídky a vysvětluje, jak je používat.
V této části
Jméno | Popis |
---|---|
o nabídkách | Popisuje nabídky. |
použití nabídek | Poskytuje příklady kódu úkolů souvisejících s nabídkami. |
Referenční nabídky | Obsahuje referenční informace k rozhraní API. |
Funkce nabídky
Jméno | Popis |
---|---|
AppendMenu | Připojí novou položku na konec zadaného řádku nabídek, rozevírací nabídky, podnabídky nebo místní nabídky. Pomocí této funkce můžete určit obsah, vzhled a chování položky nabídky. |
CheckMenuItem | Nastaví stav atributu zaškrtnutí zadané položky nabídky na vybraný nebo nezaškrtaný. |
CheckMenuRadioItem | Zkontroluje zadanou položku nabídky a nastaví ji jako přepínač. Funkce současně vymaže všechny ostatní položky nabídky v přidružené skupině a vymaže příznak typu přepínač pro tyto položky. |
CreateMenu | Vytvoří nabídku. Nabídka je zpočátku prázdná, ale může být vyplněna položkami nabídky pomocí funkcí InsertMenuItem, AppendMenua InsertMenu. |
CreatePopupMenu | Vytvoří rozevírací nabídku, podnabídku nebo místní nabídku. Nabídka je zpočátku prázdná. Položky nabídky můžete vložit nebo připojit pomocí funkce InsertMenuItem. K vložení položek nabídky a funkce AppendMenu můžete také použít funkci InsertMenu. |
DeleteMenu | Odstraní položku ze zadané nabídky. Pokud položka nabídky otevře nabídku nebo podnabídku, tato funkce zničí úchyt nabídky nebo podnabídky a uvolní paměť používanou nabídkou nebo podnabídkou. |
DestroyMenu | Zničí zadanou nabídku a uvolní veškerou paměť, kterou nabídka zabírá. |
DrawMenuBar | Překreslí řádek nabídek zadaného okna. Pokud se řádek nabídek po vytvoření okna změní, musí být tato funkce volána, aby se nakreslil změněný řádek nabídek. |
EnableMenuItem | Povolí, zakáže nebo zašedlou zadanou položku nabídky. |
EndMenu | Ukončí aktivní nabídku volajícího vlákna. |
GetMenu | Načte popisovač do nabídky přiřazené k zadanému oknu. |
GetMenuBarInfo | Načte informace o zadaném řádku nabídek. |
GetMenuCheckMarkDimensions | Načte rozměry výchozího rastrového obrázku zaškrtnutí. Systém zobrazí tento rastrový obrázek vedle vybraných položek nabídky. Před voláním funkce SetMenuItemBitmaps nahrazení výchozího rastrového obrázku zaškrtnutí pro položku nabídky musí aplikace určit správnou velikost bitmapy voláním GetMenuCheckMarkDimensions. |
GetMenuDefaultItem | Určuje výchozí položku nabídky v zadané nabídce. |
GetMenuInfo | Načte informace o zadané nabídce. |
GetMenuItemCount | Načte počet položek v zadané nabídce. |
GetMenuItemID | Načte identifikátor položky nabídky položky nabídky umístěné na zadané pozici v nabídce. |
GetMenuItemInfo | Načte informace o položce nabídky. |
GetMenuItemRect | Načte ohraničující obdélník pro zadanou položku nabídky. |
GetMenuState | Načte příznaky nabídky přidružené k zadané položce nabídky. Pokud položka nabídky otevře podnabídku, vrátí tato funkce také počet položek v podnabídce. |
GetMenuString | Zkopíruje textový řetězec zadané položky nabídky do zadané vyrovnávací paměti. |
GetSubMenu | Načte popisovač do rozevírací nabídky nebo podnabídky aktivované zadanou položkou nabídky. |
GetSystemMenu | Umožňuje aplikaci přístup k nabídce okna (označované také jako systémová nabídka nebo nabídka ovládacích prvků) pro kopírování a úpravy. |
HiliteMenuItem | Zvýrazní nebo odebere zvýraznění z položky v řádku nabídek. |
InsertMenuItem | Vloží novou položku nabídky na zadanou pozici v nabídce. |
IsMenu | Určuje, zda je úchytem nabídky. |
LoadMenu | Načte zadaný prostředek nabídky ze spustitelného souboru (.exe) přidruženého k instanci aplikace. |
LoadMenuIndirect | Načte zadanou šablonu nabídky do paměti. |
MenuItemFromPoint | Určuje, která položka nabídky, pokud existuje, je v zadaném umístění. |
ModifyMenu | Změní existující položku nabídky. Tato funkce slouží k určení obsahu, vzhledu a chování položky nabídky. |
RemoveMenu | Odstraní položku nabídky nebo oddělí podnabídku ze zadané nabídky. Pokud položka nabídky otevře rozevírací nabídku nebo podnabídku, RemoveMenu nabídku nebo jeho popisovač nezničí, což umožní opakované použití nabídky. Před zavolání této funkce by funkce GetSubMenu měla načíst popisovač rozevírací nabídky nebo podnabídky. |
SetMenu | Přiřadí do zadaného okna novou nabídku. |
SetMenuDefaultItem | Nastaví výchozí položku nabídky pro zadanou nabídku. |
SetMenuInfo | Nastaví informace pro zadanou nabídku. |
SetMenuItemBitmaps | Přidruží zadaný rastrový obrázek k položce nabídky. Bez ohledu na to, jestli je položka nabídky vybraná nebo nezaškrtnutá, zobrazí systém odpovídající rastrový obrázek vedle položky nabídky. |
SetMenuItemInfo | Změní informace o položce nabídky. |
TrackPopupMenu | Zobrazí místní nabídku v zadaném umístění a sleduje výběr položek v nabídce. Místní nabídka se může zobrazit kdekoli na obrazovce. |
TrackPopupMenuEx | Zobrazí místní nabídku v zadaném umístění a sleduje výběr položek v místní nabídce. Místní nabídka se může zobrazit kdekoli na obrazovce. |
Následující funkce je zastaralá.
Jméno | Popis |
---|---|
InsertMenu | Vloží novou položku nabídky do nabídky a přesune další položky v nabídce dolů.
Poznámka: funkce InsertMenu byla nahrazena funkcí InsertMenuItem. Přesto můžete použít InsertMenu, ale pokud nepotřebujete žádné rozšířené funkce InsertMenuItem. |
Oznámení nabídky
Jméno | Popis |
---|---|
WM_COMMAND | Odesláno, když uživatel vybere položku příkazu z nabídky, když ovládací prvek odešle zprávu s oznámením do nadřazeného okna nebo při přeložení klávesové zkratky. |
WM_CONTEXTMENU | Informuje okno, že uživatel v okně klikl pravým tlačítkem myši (pravým tlačítkem myši). |
WM_ENTERMENULOOP | Informuje hlavní okno aplikace procedura, že byla zadána modální smyčka nabídky. |
WM_EXITMENULOOP | Informuje hlavní okno aplikace procedura, že modální smyčka nabídky byla ukončena. |
WM_GETTITLEBARINFOEX | Odesláno na žádost o rozšířené informace v záhlaví. Okno obdrží tuto zprávu prostřednictvím funkce WindowProc. |
WM_MENUCOMMAND | Odesláno, když uživatel provede výběr z nabídky. |
WM_MENUDRAG | Odesláno vlastníkovi nabídky přetažení, když uživatel přetáhne položku nabídky. |
WM_MENUGETOBJECT | Odesláno vlastníkovi nabídky přetažení, když kurzor myši zadá položku nabídky nebo se přesune ze středu položky do horní nebo dolní části položky. |
WM_MENURBUTTONUP | Odesláno, když uživatel uvolní pravé tlačítko myši, zatímco kurzor je na položce nabídky. |
WM_NEXTMENU | Odesláno do aplikace, když se k přepínání mezi řádkem nabídek a systémovou nabídkou používá klávesa se šipkou doprava nebo doleva. |
WM_UNINITMENUPOPUP | Odesláno, když byla zničena rozevírací nabídka nebo podnabídka. |
Struktury nabídek
Jméno | Popis |
---|---|
MDINEXTMENU | Obsahuje informace o nabídce, která se má aktivovat. |
MENUBARINFO | Obsahuje informace o řádku nabídek. |
MENUEX_TEMPLATE_HEADER | Definuje záhlaví pro šablonu rozšířené nabídky. Tato definice struktury je určena pouze pro vysvětlení; není k dispozici v žádném standardním souboru hlavičky. |
MENUEX_TEMPLATE_ITEM | Definuje položku nabídky v šabloně rozšířené nabídky. Tato definice struktury je určena pouze pro vysvětlení; není k dispozici v žádném standardním souboru hlavičky. |
MENUGETOBJECTINFO | Obsahuje informace o nabídce, na které je kurzor myši. |
MENUINFO | Obsahuje informace o nabídce. |
MENUITEMINFO | Obsahuje informace o položce nabídky. |
MENUITEMTEMPLATE | Definuje položku nabídky v šabloně nabídky. |
MENUITEMTEMPLATEHEADER | Definuje záhlaví šablony nabídky. Kompletní šablona nabídky se skládá ze záhlaví a jednoho nebo více seznamů položek nabídky. |
TPMPARAMS | Obsahuje rozšířené parametry pro funkci TrackPopupMenuEx. |