Vcl.Menus.TMenu.DoGetMenuString

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function DoGetMenuString(Menu: HMENU; ItemID: UINT; Str: PChar;
MaxCount: Integer; Flag: UINT): Integer;

C++

int __fastcall DoGetMenuString(HMENU Menu, unsigned ItemID, System::WideChar * Str, int MaxCount, unsigned Flag);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function protected
Vcl.Menus.pas
Vcl.Menus.hpp
Vcl.Menus TMenu

Beschreibung

Gibt den Text eines Menüeintrags zurück.

DoGetMenuString wird intern verwendet, um Text von Menüeinträgen über das Windows-Handle zu ermitteln. Der Parameter Menu gibt das Handle des Menüs an. Der Parameter ItemID legt den Menüeintrag fest, dessen Text ermittelt werden soll. Wenn der Parameter Flag auf MF_BYCOMMAND gesetzt ist, ist ItemID die Eigenschaft Command des Menüeintrags. Wenn Flag auf MF_BYPOSITION gesetzt ist, ist ItemID der nullbasierte Index des Menüeintrags. Der Text wird in einem Puffer übergeben, auf den der Parameter Str zeigt. MaxCount gibt die Größe dieses Puffers an.

Im Gegensatz zu der Windows-API-Funktion GetMenuString übergibt DoGetMenuString den korrekten Text von OwnerDraw-Menüeinträgen zurück.

Siehe auch