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
S_OK	메서드를 성공적으로 수행했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_OUTOFMEMORY	메모리 할당 오류가 발생했습니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ctfutb.h
DLL	Msctf.dll
재배포 가능 파일	Windows 2000 Professional의 TSF 1.0

추가 정보

ITfMenu

TF_LBMENUF_* 상수