Freigeben über


CMenu::GetMenuString

Kopiert die Bezeichnung des angegebenen Menüelements zum angegebenen Puffer.

int GetMenuString( 
   UINT nIDItem, 
   LPTSTR lpString, 
   int nMaxCount, 
   UINT nFlags  
) const; 
int GetMenuString( 
   UINT nIDItem, 
   CString& rString, 
   UINT nFlags  
) const;

Parameter

  • nIDItem
    Gibt den ganzzahligen Bezeichner des Menüelements oder den Offset des Menüelements im Menü, je nach Wert von nFlags an.

  • lpString
    Zeigt auf den Puffer, der, die Bezeichnung zu empfangen wird.

  • rString
    Ein Verweis auf ein Objekt, das CString, die kopierte Menüzeichenfolge zu empfangen wird.

  • nMaxCount
    Gibt die maximale Länge (in Zeichen) der zu kopierenden Bezeichnung. Wenn die Bezeichnung länger als die maximal zulässige ist, das in nMaxCount angegeben wird, werden die zusätzlichen Zeichen abgeschnitten.

  • nFlags
    Gibt die Interpretation des nIDItem-Parameters an. Es kann einer der folgenden Werte sein:

    nFlags

    Interpretation von nIDItem

    MF_BYCOMMAND

    Gibt an, dass der Parameter der Befehls-ID des vorhandenen Menüelements gibt. Dies ist der Standardwert, wenn weder noch MF_BYCOMMANDMF_BYPOSITION festgelegt ist.

    MF_BYPOSITION

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

Rückgabewert

Gibt die tatsächliche Anzahl von Zeichen an, die auf den Puffer, ohne das NULL-Zeichen kopiert werden.

Hinweise

Der nMaxCount-Parameter sollte einer sein, der Zeichen in der Bezeichnung größer als die Anzahl ist, um den NULL-Zeichens anzupassen, das eine Zeichenfolge endet.

Beispiel

Im Beispiel für CMenu::InsertMenu.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CMenu-Klasse

Hierarchiediagramm

CMenu::GetMenuState

CMenu::ModifyMenu

GetMenuString