ITfMenu::AddMenuItem 메서드(ctfutb.h)
언어 모음이 단추에 대해 표시할 메뉴에 항목을 추가합니다.
구문
HRESULT AddMenuItem(
[in] UINT uId,
[in] DWORD dwFlags,
[in] HBITMAP hbmp,
[in] HBITMAP hbmpMask,
[in] const WCHAR *pch,
[in] ULONG cch,
ITfMenu **ppMenu
);
매개 변수
[in] uId
메뉴 항목 식별자를 포함합니다.
[in] dwFlags
메뉴 항목의 형식과 상태를 지정하는 하나 이상의 TF_LBMENUF_* 값의 조합 또는 0을 포함합니다.
[in] hbmp
메뉴 항목에 대해 그린 비트맵의 핸들을 포함합니다. NULL이면 메뉴 항목에 대한 비트맵이 표시되지 않습니다.
[in] hbmpMask
마스크 비트맵의 핸들을 포함합니다. hbmp의 마스크로 작동하는 단색 비트맵입니다. 이 비트맵의 각 검은색 픽셀은 hbmp 의 해당 픽셀을 일반 색으로 표시합니다. 이 비트맵의 각 흰색 픽셀은 hbmp 의 해당 픽셀을 표준 색의 역으로 표시합니다.
색 변환 없이 비트맵을 표시하려면 hbmp 와 동일한 크기의 단색 비트맵을 만들고 각 픽셀을 검은색으로 설정합니다(RGB(0, 0, 0)).
hbmp가 NULL이면 이 매개 변수는 무시됩니다.
[in] pch
메뉴 항목에 대해 표시할 텍스트가 포함된 WCHAR 버퍼에 대한 포인터입니다. 텍스트의 길이는 cch로 지정됩니다.
[in] cch
pch의 메뉴 항목 텍스트 길이(WCHAR)를 지정합니다.
ppMenu
[in, out] 하위 메뉴 개체를 수신하는 ITfMenu 인터페이스 포인터에 대한 포인터입니다. 이 매개 변수는 사용되지 않으며 dwFlags에 TF_LBMENUF_SUBMENU 포함되어 있지 않은 경우 NULL이어야 합니다.
하위 메뉴 항목이 성공적으로 만들어지면 이 매개 변수는 호출자가 하위 메뉴에 항목을 추가하는 데 사용하는 ITfMenu 개체를 받습니다.
dwFlags에 TF_LBMENUF_SUBMENU 포함된 경우 대부분의 경우 마샬링된 호출이므로 이 메서드를 호출하기 전에 이 값을 NULL로 초기화해야 합니다. 이 변수를 초기화하지 않을 경우 마샬러가 임의 메모리에 액세스하려고 시도합니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 값 | Description |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
지정되지 않은 오류가 발생했습니다. |
|
메모리 할당 오류가 발생했습니다. |
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | ctfutb.h |
| DLL | Msctf.dll |
| 재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |