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
새 메뉴 항목의 모양과 동작을 제어합니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.
| 값 | 의미 |
|---|---|
|
비트맵을 메뉴 항목으로 사용합니다. lpNewItem 매개 변수는 비트맵에 대한 핸들을 포함합니다. |
|
메뉴 항목 옆에 검사 표시를 배치합니다. 애플리케이션에서 검사 표시 비트맵을 제공하는 경우(SetMenuItemBitmaps 참조) 이 플래그는 메뉴 항목 옆에 검사 표시 비트맵을 표시합니다. |
|
메뉴 항목을 선택할 수 없도록 사용하지 않도록 설정하지만 플래그는 회색으로 표시되지 않습니다. |
|
메뉴 항목을 선택할 수 있도록 설정하고 회색 상태에서 복원합니다. |
|
메뉴 항목을 사용하지 않도록 설정하고 선택할 수 없도록 회색으로 표시합니다. |
|
메뉴 모음의 MF_MENUBREAK 플래그와 동일하게 작동합니다. 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴의 경우 새 열은 이전 열과 세로 줄로 구분됩니다. |
|
열을 구분하지 않고 새 줄(메뉴 모음의 경우) 또는 새 열(드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴의 경우)에 항목을 배치합니다. |
|
항목이 소유자가 그린 항목임을 지정합니다. 메뉴가 처음으로 표시되기 전에 메뉴를 소유하는 창은 메뉴 항목의 너비와 높이를 검색하는 WM_MEASUREITEM 메시지를 받습니다. WM_DRAWITEM 메시지는 메뉴 항목의 모양을 업데이트해야 할 때마다 소유자 창의 창 프로시저로 전송됩니다. |
|
메뉴 항목이 드롭다운 메뉴 또는 하위 메뉴를 열게 지정합니다. uIDNewItem 매개 변수는 드롭다운 메뉴 또는 하위 메뉴에 대한 핸들을 지정합니다. 이 플래그는 메뉴 모음에 메뉴 이름을 추가하거나 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에 하위 메뉴를 여는 메뉴 항목을 추가하는 데 사용됩니다. |
|
가로 구분선을 그립니다. 이 플래그는 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에서만 사용됩니다. 선은 회색으로 표시하거나 사용하지 않도록 설정하거나 강조 표시할 수 없습니다. lpNewItem 및 uIDNewItem 매개 변수는 무시됩니다. |
|
메뉴 항목이 텍스트 문자열임을 지정합니다. lpNewItem 매개 변수는 문자열에 대한 포인터입니다. |
|
항목(기본값) 옆에 검사 표시를 배치하지 않습니다. 애플리케이션에서 검사 표시 비트맵을 제공하는 경우(SetMenuItemBitmaps 참조) 이 플래그는 메뉴 항목 옆에 명확한 비트맵을 표시합니다. |
[in] uIDNewItem
형식: UINT_PTR
새 메뉴 항목의 식별자이거나 uFlags 매개 변수가 MF_POPUP 설정되면 드롭다운 메뉴 또는 하위 메뉴에 대한 핸들입니다.
[in, optional] lpNewItem
형식: LPCTSTR
새 메뉴 항목의 콘텐츠입니다. lpNewItem의 해석은 uFlags 매개 변수에 다음 값이 포함되는지 여부에 따라 달라집니다.
| 값 | 의미 |
|---|---|
|
비트맵 핸들을 포함합니다. |
|
메뉴 항목과 관련된 추가 데이터를 유지하는 데 사용할 수 있는 애플리케이션 제공 값을 포함합니다. 값은 메뉴가 만들어지거나 모양이 업데이트되면 전송되는 WM_MEASUREITEM 또는 WM_DRAWITEM 메시지의 lParam 매개 변수가 가리키는 구조체의 itemData 멤버에 있습니다. |
|
null로 끝나는 문자열에 대한 포인터를 포함합니다. |
반환 값
형식: BOOL
함수가 성공하면 반환 값이 0이 아닙니다. 함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
메뉴가 표시된 창에 있는지 여부에 관계없이 메뉴가 변경될 때마다 애플리케이션에서 DrawMenuBar 함수를 호출해야 합니다.
키보드 가속기가 비트맵 또는 소유자가 그린 메뉴 항목과 함께 작동하도록 하려면 메뉴 소유자가 WM_MENUCHAR 메시지를 처리해야 합니다. 자세한 내용은 소유자 그리기 메뉴 및 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를 유니코드 전처리기 상수의 정의에 따라 이 함수의 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에 도입됨) |
추가 정보
개념
참조