MENUITEMINFOA 구조체(winuser.h)
메뉴 항목에 대한 정보를 포함합니다.
통사론
typedef struct tagMENUITEMINFOA {
UINT cbSize;
UINT fMask;
UINT fType;
UINT fState;
UINT wID;
HMENU hSubMenu;
HBITMAP hbmpChecked;
HBITMAP hbmpUnchecked;
ULONG_PTR dwItemData;
LPSTR dwTypeData;
UINT cch;
HBITMAP hbmpItem;
} MENUITEMINFOA, *LPMENUITEMINFOA;
회원
cbSize
형식: UINT
구조체의 크기(바이트)입니다. 호출자는 이 멤버를 sizeof(MENUITEMINFO)
설정해야 합니다.
fMask
형식: UINT
검색하거나 설정할 멤버를 나타냅니다. 이 멤버는 다음 값 중 하나 이상일 수 있습니다.
fType
형식: UINT
메뉴 항목 유형입니다. 이 멤버는 다음 값 중 하나 이상일 수 있습니다.
MFT_BITMAP, MFT_SEPARATOR및 MFT_STRING 값을 서로 결합할 수 없습니다. fType사용하도록 MIIM_TYPEfMask 설정합니다.
fTypefMask 값이 MIIM_FTYPE경우에만 사용됩니다.
값 | 의미 |
---|---|
|
비트맵을 사용하여 메뉴 항목을 표시합니다.
dwTypeData 멤버의 하위 단어는 비트맵 핸들이며 cch 멤버는 무시됩니다.
MFT_BITMAPMIIM_BITMAP 및 hbmpItem대체됩니다. |
|
메뉴 항목을 새 줄(메뉴 모음의 경우) 또는 새 열(드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴)에 배치합니다. 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴의 경우 세로줄은 새 열을 이전 열과 구분합니다. |
|
메뉴 항목을 새 줄(메뉴 모음의 경우) 또는 새 열(드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴)에 배치합니다. 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴의 경우 열은 세로선으로 구분되지 않습니다. |
|
메뉴를 소유하는 창에 메뉴 항목을 그리는 책임을 할당합니다. 창은 메뉴가 처음으로 표시되기 전에 WM_MEASUREITEM 메시지를 수신하고 메뉴 항목의 모양을 업데이트해야 할 때마다 WM_DRAWITEM 메시지를 받습니다. 이 값을 지정하면 dwTypeData 멤버에 애플리케이션 정의 값이 포함됩니다. |
|
|
|
메뉴 항목 및 후속 항목을 오른쪽 맞춤합니다. 이 값은 메뉴 항목이 메뉴 모음에 있는 경우에만 유효합니다. |
|
메뉴가 오른쪽에서 왼쪽으로 계단식으로 배열되도록 지정합니다(기본값은 왼쪽에서 오른쪽). 아랍어 및 히브리어와 같은 오른쪽에서 왼쪽으로 쓰는 언어를 지원하는 데 사용됩니다. |
|
메뉴 항목이 구분 기호임을 지정합니다. 메뉴 항목 구분 기호가 가로 구분선으로 나타납니다. dwTypeData 및 cch 멤버는 무시됩니다. 이 값은 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에서만 유효합니다. |
|
텍스트 문자열을 사용하여 메뉴 항목을 표시합니다.
dwTypeData 멤버는 null로 끝나는 문자열에 대한 포인터이고 cch 멤버는 문자열의 길이입니다.
MFT_STRINGMIIM_STRING대체됩니다. |
fState
형식: UINT
메뉴 항목 상태입니다. 이 멤버는 이러한 값 중 하나 이상일 수 있습니다. fState사용하도록 fMaskMIIM_STATE 설정합니다.
wID
형식: UINT
메뉴 항목을 식별하는 애플리케이션 정의 값입니다. wID사용하도록 MIIM_IDfMask 설정합니다.
hSubMenu
형식: HMENU
메뉴 항목과 연결된 드롭다운 메뉴 또는 하위 메뉴에 대한 핸들입니다. 메뉴 항목이 드롭다운 메뉴 또는 하위 메뉴를 여는 항목이 아닌 경우 이 멤버는 NULL
hbmpChecked
형식: HBITMAP
선택한 경우 항목 옆에 표시할 비트맵에 대한 핸들입니다. 이 멤버가 NULL
hbmpUnchecked
형식: HBITMAP
항목이 선택되지 않은 경우 항목 옆에 표시할 비트맵에 대한 핸들입니다. 이 멤버가 NULL
dwItemData
형식: ULONG_PTR
메뉴 항목과 연결된 애플리케이션 정의 값입니다. dwItemData사용하도록 fMaskMIIM_DATA 설정합니다.
dwTypeData
형식: LPTSTR
메뉴 항목의 내용입니다. 이 멤버의 의미는 fType 값에 따라 달라지며 MIIM_TYPE 플래그가 fMask 멤버에 설정된 경우에만 사용됩니다.
SetMenuItemInfo 함수와 함께 사용하는 경우 이 멤버는 형식이 fType 멤버에 의해 지정된 값을 포함해야 합니다.
dwTypeDataMIIM_STRING 플래그가 fMask 멤버에 설정된 경우에만 사용됩니다.
cch
형식: UINT
MFT_STRING 유형의 메뉴 항목에 대한 정보가 수신되는 경우 메뉴 항목 텍스트의 길이(문자)입니다. 그러나 cchMIIM_TYPE 플래그가 fMask 멤버에 설정되어 있고 그렇지 않으면 0인 경우에만 사용됩니다. 또한 SetMenuItemInfo호출하여 메뉴 항목의 콘텐츠를 설정할 때 cch 무시됩니다.
GetMenuItemInfo
MIIM_STRING 플래그가 fMask 멤버에 설정된 경우 cch 멤버가 사용됩니다.
hbmpItem
형식: HBITMAP
표시할 비트맵에 대한 핸들이거나 다음 표의 값 중 하나일 수 있습니다. fMask 멤버에서 MIIM_BITMAP 플래그를 설정할 때 사용됩니다.
값 | 의미 |
---|---|
|
메뉴를 소유하는 창에서 그린 비트맵입니다. 애플리케이션은 WM_MEASUREITEM 처리하고 메시지를 WM_DRAWITEM 합니다. |
|
메뉴 모음의 닫기 단추입니다. |
|
메뉴 모음의 닫기 단추를 사용하지 않도록 설정했습니다. |
|
메뉴 모음의 최소화 단추입니다. |
|
메뉴 모음의 사용 안 함 최소화 단추입니다. |
|
메뉴 모음의 복원 단추입니다. |
|
하위 메뉴의 닫기 단추입니다. |
|
하위 메뉴의 최대화 단추입니다. |
|
하위 메뉴의 최소화 단추입니다. |
|
하위 메뉴의 복원 단추입니다. |
|
windows 아이콘 또는 dwItemData지정된 창의 아이콘입니다. |
발언
MENUITEMINFO 구조체는 GetMenuItemInfo, InsertMenuItem및 SetMenuItemInfo 함수와 함께 사용됩니다.
메뉴는 텍스트, 비트맵 또는 둘 다를 사용하여 항목을 표시할 수 있습니다.
메모
winuser.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 MENUITEMINFO를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
요구 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
헤더 | winuser.h(Windows.h 포함) |
참고 항목
개념
GetMenuItemInfo
InsertMenuItem
참조
SetMenuItemInfo