GetMenuDefaultItem 함수(winuser.h)

아티클
03/13/2024

지정된 메뉴에서 기본 메뉴 항목을 결정합니다.

구문

UINT GetMenuDefaultItem(
  [in] HMENU hMenu,
  [in] UINT  fByPos,
  [in] UINT  gmdiFlags
);

매개 변수

[in] hMenu

형식: HMENU

기본 메뉴 항목을 검색할 메뉴에 대한 핸들입니다.

[in] fByPos

형식: UINT

메뉴 항목의 식별자 또는 해당 위치를 검색할지 여부를 나타냅니다. 이 매개 변수가 FALSE이면 식별자가 반환됩니다. 그렇지 않으면 위치가 반환됩니다.

[in] gmdiFlags

형식: UINT

함수가 메뉴 항목을 검색하는 방법을 나타냅니다. 이 매개 변수는 다음 값 중 0개 이상일 수 있습니다.

값

의미

GMDI_GOINTOPOPUPS
0x0002L

기본 항목이 하위 메뉴가 열리는 항목인 경우 함수는 해당 하위 메뉴에서 재귀적으로 검색하는 것입니다. 하위 메뉴에 기본 항목이 없는 경우 반환 값은 하위 메뉴가 열리는 항목을 식별합니다. 기본적으로 함수는 하위 메뉴를 여는 항목인지 여부에 관계없이 지정된 메뉴의 첫 번째 기본 항목을 반환합니다.

GMDI_USEDISABLED
0x0001L

함수는 사용하지 않도록 설정된 경우에도 기본 항목을 반환하는 것입니다. 기본적으로 함수는 비활성화되거나 회색으로 표시된 항목을 건너뜁니다.

반환 값

형식: UINT

함수가 성공하면 반환 값은 메뉴 항목의 식별자 또는 위치입니다.

함수가 실패하면 반환 값은 -1입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-menu-l1-1-0(Windows 8 도입)

추가 정보

개념

참조

SetMenuDefaultItem