Freigeben über


CMenu::CheckMenuItem

Fügt Häkchen hinzu oder entfernt Häkchen von den Menüelementen im Popupmenü.

UINT CheckMenuItem( 
   UINT nIDCheckItem, 
   UINT nCheck  
);

Parameter

  • nIDCheckItem
    Gibt das zu überprüfende an Menüelement, wie durch nCheck bestimmt wurde.

  • nCheck
    Gibt an, wie das Menüelement überprüft und wie die Position des Elements im Menü bestimmt. Der nCheck-Parameter kann eine Kombination von MF_CHECKED oder von MF_UNCHECKED mit MF_BYPOSITION oder MF_BYCOMMAND-Flags sein. Diese Flags können kombiniert werden, indem Sie den bitweisen Operator OR verwendet wird. Sie haben folgende Bedeutung:

    • MF_BYCOMMAND gibt an, dass der Parameter der Befehls-ID des vorhandenen Menüelements gibt. Dies ist die Standardeinstellung.

    • MF_BYPOSITION gibt an, dass der Parameter die Position des vorhandenen Menüelements gibt. Der erste Punkt befindet sich an Position 0.

    • MF_CHECKED fungiert als eine Umschaltfläche mit MF_UNCHECKED auf, um das Häkchen neben dem Element zu platzieren.

    • MF_UNCHECKED fungiert als eine Umschaltfläche mit MF_CHECKED auf, um ein Häkchen neben dem Element zu entfernen.

Rückgabewert

Der vorherige Zustand des Elements: MF_CHECKED oder MF_UNCHECKED oder 0xFFFFFFFF, wenn das Menüelement nicht vorhanden war.

Hinweise

Der nIDCheckItem-Parameter gibt das zu ändernde Element, an.

Der nIDCheckItem-Parameter identifiziert werden ein Popupmenüelement sowie ein Menüelement. Keine speziellen Schritte erforderlich, ein Popupmenüelement zu überprüfen. Menüelemente der obersten Ebene können nicht überprüft werden. Ein Popupmenüelement muss durch Position überprüft werden, da es keinen Menüelementbezeichner verfügt, der zugeordnet ist.

Beispiel

Im Beispiel für CMenu::GetMenuState.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CMenu-Klasse

Hierarchiediagramm

CMenu::GetMenuState

CheckMenuItem

CMenu::CheckMenuRadioItem