다음을 통해 공유

ITextInputPanel::SetInPlaceHoverTargetPosition 메서드(peninputpanel.h)

  • 아티클

[ITextInputPanel 은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 IInputPanelConfiguration을 사용합니다.

]

태블릿 PC 입력 패널 가리키기 대상을 화면 좌표로 명시적으로 배치합니다.

구문

HRESULT SetInPlaceHoverTargetPosition(
  int xPosition,
  int yPosition
);

매개 변수

xPosition

보정 빗이 보이지 않는 가리키기 대상의 왼쪽 위 모서리에 대한 가로 x 좌표입니다.

yPosition

보정 빗이 보이지 않는 가리키기 대상의 왼쪽 위 모서리에 대한 세로 y 좌표입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 성공.
E_FAIL
 지정되지 않은 오류가 발생했습니다.

설명

가리키기 대상을 배치할 수 있는 위치에는 제한이 없습니다. 애플리케이션은 호버 대상이 화면에 유지되도록 해야 합니다.

SetInPlaceHoverTargetPosition 메서드는 동기적입니다. 위치 지정은 메서드가 반환되기 전에 발생합니다.

예제

이 C++ 예제에서는 편집 컨트롤 IDC_EDIT2에 EN_SETFOCUS 대한 이벤트 처리기를 구현합니다. 먼저 ITextInputPanel 개체 가 g_pTip만들어졌는지 확인합니다. 있는 경우 ITextInputPanel::SetInPlaceHoverTargetPosition 메서드를 호출하여 입력 패널 가리키기 대상의 위치를 설정합니다. 그런 다음 TRACE 매크로를 사용하여 호출이 출력을 디버그하는 데 성공했는지 여부를 보고합니다.

void CCOMTIPDlg::OnEnSetfocusEdit2()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceHoverTargetPosition(300, 300)))
		{
			TRACE("Call to SetInPlaceHoverTargetPosition() succeeded.\n");
		}
		else
		{
			TRACE("Call to SetInPlaceHoverTargetPosition() failed.\n");
		}
	}
    else
    {
        TRACE("ITextInputPanel object is NULL.\n");
    }
}

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 peninputpanel.h
DLL Tiptsf.dll

추가 정보

ITextInputPanel 인터페이스

ITextInputPanel::SetInPlacePosition 메서드

ITextInputPanel::SetInPlaceVisibility 메서드