CMenu::GetMenuString

Artikel
02/26/2013

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.