다음을 통해 공유


AppendMenuA 함수(winuser.h)

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

구문

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
가로 구분선을 그립니다. 이 플래그는 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에서만 사용됩니다. 선은 회색으로 표시하거나 사용하지 않도록 설정하거나 강조 표시할 수 없습니다. lpNewItemuIDNewItem 매개 변수는 무시됩니다.
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 메시지를 처리해야 합니다. 자세한 내용은 소유자 그리기 메뉴 및 WM_MENUCHAR 메시지를 참조하세요.

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

  • MF_BITMAP, MF_STRINGMF_OWNERDRAW
  • MF_CHECKEDMF_UNCHECKED
  • MF_DISABLED, MF_ENABLEDMF_GRAYED
  • MF_MENUBARBREAKMF_MENUBREAK

예제

예제는 메뉴에 선 및 그래프 추가를 참조하세요.

참고

winuser.h 헤더는 APPendMenu를 유니코드 전처리기 상수의 정의에 따라 이 함수의 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에 도입됨)

추가 정보

개념

CreateMenu

DeleteMenu

DestroyMenu

DrawMenuBar

InsertMenu

InsertMenuItem

메뉴

ModifyMenu

참조

RemoveMenu

SetMenuItemBitmaps