GetMenuItemInfo(A)

GetMenuItemInfo(A)

메뉴 아이템의 정보를 취득합니다.

BOOL GetMenuItemInfoA(
    HMENU hMenu,             // 메뉴 핸들
    UINT  uItem,             // 아이템의ID또는 위치
    BOOL  fByPosition,       // 플래그
    LPMENUITEMINFO pItemInfo // MENUITEMINFO구조체
);

USER32.DLL

인수

hMenu

메뉴의 핸들을 지정합니다.

uItem

아이템 ID 또는 아이템의 위치를 지정합니다.어느 쪽을 나타낼까는 fByPosition 파라미터의 값에 의존합니다.

fByPosition

uItem 파라미터의 의미를 지정합니다. 0 (FALSE) (을)를 지정하면,uItem 파라미터가 메뉴 아이템 ID 인 것을 나타냅니다. 1 (TRUE) (을)를 지정하면, 메뉴 아이템의 위치의 인덱스인 것을 나타냅니다.

pItemInfo

MENUITEMINFO 구조체의 주소를 지정합니다.이 구조체에 아이템의 정보가 격납됩니다.

반환값

성공하면 0 이외의 값이 돌아갑니다.

실패하면 0 하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

해설

MFT_STRING 형태의 메뉴 아이템의 정보를 취득할 때에, MENUITEMINFO 구조체의 dwTypeData 멤버에 0 (NULL) (을)를 세트 하고 나서 GetMenuItemInfo 함수를 호출하는 것으로, cch 멤버에 문자열의 길이를 취득할 수 있습니다.그 후, 이 문자열을 격납 가능한 한의 버퍼를 확보하고, 이 버퍼의 주소를 dwTypeData 멤버에 격납하고 나서 다시 GetMenuItemInfo 함수를 호출하는 것으로, 버퍼에 문자열을 취득할 수 있습니다.

대응 정보

Windows 95 이후 / Windows NT 4.0 이후