AppendMenuA 함수(winuser.h)

아티클
11/20/2024

지정한 메뉴 모음, 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴의 끝에 새 항목을 추가합니다. 이 함수를 사용하여 메뉴 항목의 콘텐츠, 모양 및 동작을 지정할 수 있습니다.

통사론

BOOL AppendMenuA(
  [in]           HMENU    hMenu,
  [in]           UINT     uFlags,
  [in]           UINT_PTR uIDNewItem,
  [in, optional] LPCSTR   lpNewItem
);

매개 변수

[in] hMenu

형식: HMENU

변경할 메뉴 모음, 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에 대한 핸들입니다.

[in] uFlags

형식: UINT

새 메뉴 항목의 모양과 동작을 제어합니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.

값	의미
MF_BITMAP 0x00000004L	비트맵을 메뉴 항목으로 사용합니다. lpNewItem 매개 변수에는 비트맵에 대한 핸들이 포함되어 있습니다.
MF_CHECKED 0x00000008L	메뉴 항목 옆에 확인 표시를 배치합니다. 애플리케이션에서 확인 표시 비트맵을 제공하는 경우(SetMenuItemBitmaps참조) 이 플래그는 메뉴 항목 옆에 확인 표시 비트맵을 표시합니다.
MF_DISABLED 0x00000002L	선택할 수 없도록 메뉴 항목을 사용하지 않도록 설정하지만 플래그는 회색으로 표시되지 않습니다.
MF_ENABLED 0x00000000L	메뉴 항목을 선택할 수 있도록 설정하고 회색 상태에서 복원합니다.
MF_GRAYED 0x00000001L	메뉴 항목을 사용하지 않도록 설정하고 선택할 수 없도록 회색으로 표시합니다.
MF_MENUBARBREAK 0x00000020L	메뉴 모음의 MF_MENUBREAK 플래그와 동일하게 작동합니다. 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴의 경우 새 열은 이전 열과 세로줄로 구분됩니다.
MF_MENUBREAK 0x00000040L	열을 구분하지 않고 새 줄(메뉴 모음의 경우) 또는 새 열(드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴의 경우)에 항목을 배치합니다.
MF_OWNERDRAW 0x00000100L	항목이 소유자가 그린 항목임을 지정합니다. 메뉴가 처음으로 표시되기 전에 메뉴를 소유하는 창은 메뉴 항목의 너비와 높이를 검색하는 WM_MEASUREITEM 메시지를 받습니다. 그런 다음 메뉴 항목의 모양을 업데이트해야 할 때마다 WM_DRAWITEM 메시지가 소유자 창의 창 프로시저로 전송됩니다.
MF_POPUP 0x00000010L	메뉴 항목이 드롭다운 메뉴 또는 하위 메뉴를 열게 지정합니다. uIDNewItem 매개 변수는 드롭다운 메뉴 또는 하위 메뉴에 대한 핸들을 지정합니다. 이 플래그는 메뉴 모음에 메뉴 이름을 추가하거나 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에 하위 메뉴를 여는 메뉴 항목을 추가하는 데 사용됩니다.
MF_SEPARATOR 0x00000800L	가로 구분선을 그립니다. 이 플래그는 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에서만 사용됩니다. 선은 회색으로 표시하거나 사용하지 않도록 설정하거나 강조 표시할 수 없습니다. lpNewItem 및 uIDNewItem 매개 변수는 무시됩니다.
MF_STRING 0x00000000L	메뉴 항목이 텍스트 문자열임을 지정합니다. lpNewItem 매개 변수는 문자열에 대한 포인터입니다.
MF_UNCHECKED 0x00000000L	항목 옆에 확인 표시를 배치하지 않습니다(기본값). 애플리케이션에서 확인 표시 비트맵을 제공하는 경우(SetMenuItemBitmaps참조) 이 플래그는 메뉴 항목 옆에 명확한 비트맵을 표시합니다.

[in] uIDNewItem

형식: UINT_PTR

새 메뉴 항목의 식별자이거나, uFlags 매개 변수가 MF_POPUP설정되면 드롭다운 메뉴 또는 하위 메뉴에 대한 핸들입니다.

[in, optional] lpNewItem

형식: LPCTSTR

새 메뉴 항목의 내용입니다. lpNewItem 해석은 uFlags 매개 변수에 다음 값이 포함되는지 여부에 따라 달라집니다.

값	의미
MF_BITMAP 0x00000004L	비트맵 핸들을 포함합니다.
MF_OWNERDRAW 0x00000100L	메뉴 항목과 관련된 추가 데이터를 유지하는 데 사용할 수 있는 애플리케이션 제공 값을 포함합니다. 이 값은 메뉴가 만들어지거나 모양이 업데이트될 때 전송된 WM_MEASUREITEM 또는 WM_DRAWITEM 메시지의 lParam 매개 변수가 가리키는 구조체의 itemData 멤버에 있습니다.
MF_STRING 0x00000000L	null로 끝나는 문자열에 대한 포인터를 포함합니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값은 0이 아닌 값입니다. 함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.

발언

메뉴가 표시된 창에 있는지 여부에 관계없이 메뉴가 변경될 때마다 애플리케이션에서 DrawMenuBar 함수를 호출해야 합니다.

키보드 가속기가 비트맵 또는 소유자가 그린 메뉴 항목을 사용할 수 있도록 하려면 메뉴 소유자가 WM_MENUCHAR 메시지를 처리해야 합니다. 자세한 내용은 Owner-Drawn 메뉴 및 WM_MENUCHAR 메시지참조하세요.

다음 플래그 그룹을 함께 사용할 수 없습니다.

MF_BITMAP, MF_STRING및 MF_OWNERDRAW
MF_CHECKED 및 MF_UNCHECKED
MF_DISABLED, MF_ENABLED및 MF_GRAYED
MF_MENUBARBREAK 및 MF_MENUBREAK

예제

예를 들어 메뉴선 및 그래프 추가 참조하세요.

메모

winuser.h 헤더는 APPendMenu를 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	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에서 도입)