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

아티클
03/01/2024

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

]

태블릿 PC 입력 패널을 표시하거나 숨깁니다.

구문

HRESULT SetInPlaceVisibility(
  BOOL Visible
);

매개 변수

Visible

TRUE 이면 입력 패널이 표시됩니다. FALSE 이면 입력 패널을 숨깁니다.

반환 값

입력 패널을 표시할 수 있는 경우 메서드는 S_OK 반환하고, 그렇지 않으면 E_FAIL. 입력 패널이 ITextInputPanel::SetInPlaceVisibility 메서드의 영향을 받을 수 있고 영향을 받을 수 없는 경우에 대한 자세한 내용은 설명 섹션을 참조하세요.

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

설명

입력 패널은 ITextInputPanel::CurrentInPlaceState 속성 속성 에 지정된 대로 표시됩니다.

입력 패널이 이미 표시되는 경우 Visible 매개 변수가 TRUE로 설정된 ITextInputPanel::SetInPlaceVisibility 메서드를 호출하면 실패합니다.

사용자가 입력 패널 옵션 대화 상자에서 현재 위치 모드를 사용하지 않도록 설정한 경우 ITextInputPanel::SetInPlaceVisibility 메서드 를 호출하지 못합니다.

표시 유형이 변경되면 입력 패널에 이미 있는 모든 잉크가 자동으로 삽입됩니다.

이 메서드는 ITextInputPanel::InPlaceVisibleOnFocus 속성의 값을 변경하지 않으며, 후속 포커스 변경 시 동작은 ITextInputPanel::InPlaceVisibleOnFocus 속성에 지정된 동작으로 되돌아갑니다.

ITextInputPanel::SetInPlaceVisibility 메서드는 동기 호출입니다. 호출이 반환되기 전에 입력 패널 표시 유형이 변경됩니다.

예제

이 C++ 예제에서는 편집 컨트롤 IDC_EDIT1에 EN_SETFOCUS 대한 이벤트 처리기를 구현합니다. 먼저 ITextInputPanel 개체 가 g_pTip만들어졌는지 확인합니다. 있는 경우 Visible 매개 변수에 대해 값이 false인 ITextInputPanel::SetInPlaceVisibility 메서드를 호출하여 입력 패널이 표시되지 않습니다.

void CCOMTIPDlg::OnEnSetfocusEdit1()
{
	if (NULL != g_pTip)
	{
		if (SUCCEEDED(g_pTip->SetInPlaceVisibility(false)))
		{
			TRACE("Successfully hid the Input Panel.\n");
		}
	}
}

요구 사항

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