ITextServices::OnTxInPlaceActivate 메서드(textserv.h)

아티클
08/26/2023

텍스트 서비스 개체에 이 컨트롤이 현재 위치로 활성 상태임을 알립니다.

구문

HRESULT OnTxInPlaceActivate(
  [in] LPCRECT prcClient
);

매개 변수

[in] prcClient

형식: const RECT*

컨트롤의 클라이언트 사각형입니다.

반환 값

형식: HRESULT

개체가 성공적으로 활성화되면 반환 값이 S_OK.

오류로 인해 개체를 활성화할 수 없는 경우 반환 값이 E_FAIL. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

설명

현재 위치 활성은 포함된 개체가 현재 위치에서 실행 되고 있음을 의미합니다(예: 일반 컨트롤 및 포함의 경우 그릴 창이 있는 경우). 반면 UI 활성은 개체에 현재 편집 포커스가 있음을 의미합니다. 예를 들어 컨테이너의 메뉴 및 도구 모음과 같은 항목에는 UI 활성 컨트롤/포함 요소도 포함될 수 있습니다. 현재 위치 활성 컨트롤이 많을 수 있지만 지정된 시간에는 UI 활성 컨트롤이 하나만 있습니다.

UI 활성화는 포커스를 가져오는 것과 다릅니다. 컨트롤이 포커스를 가져오거나 잃고 있음을 텍스트 서비스 개체에 알리기 위해 호스트는 WM_SETFOCUS 보내고 메시지를 WM_KILLFOCUS . 또한 창 없는 호스트는 이러한 메시지에 대한 wParam(포커스를 잃은 창)으로 NULL을 전달합니다.

비활성 상태에서 UI 활성 상태로 직접 전환할 때 호스트는 먼저 ITextServices::OnTxInPlaceActivate 를 호출한 다음 ITextServices::OnTxUIActivate를 호출해야 합니다.

ITextServices::OnTxInPlaceActivate 는 활성화되는 뷰의 클라이언트 사각형을 매개 변수로 사용합니다. 이 사각형은 포함된 창의 클라이언트 좌표에 제공됩니다. 호스트에서 TxGetClientRect 를 호출하여 가져오는 것과 동일합니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	textserv.h
DLL	Msftedit.dll