IPenInputPanel::EnableTsf 메서드(peninputpanel.h)

아티클
08/25/2023

[ PenInputPanel 이 TIP(텍스트 입력 패널)로 대체되었습니다.]

더 이상 사용되지 않습니다. PenInputPanel 개체가 TSF(Text Services Framework)를 통해 연결된 컨트롤에 텍스트를 보내려고 하고 수정 사용자 인터페이스를 사용할 수 있는지 여부를 나타내는 부울 값을 가져오거나 설정합니다.

구문

HRESULT EnableTsf(
  VARIANT_BOOL Enable
);

매개 변수

Enable

True 이면 PenInputPanel 개체가 TSF를 사용하여 연결된 컨트롤에 텍스트를 보내려고 하고 수정 사용자 인터페이스를 사용하도록 설정해야 합니다. 그렇지 않으면 FALSE입니다. 기본값은 TRUE입니다.

반환 값

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

반환 코드	설명
S_OK	성공.
E_UNEXPECTED	예기치 않은 매개 변수 또는 속성 형식입니다.
E_NOINTERFACE	TSF 인터페이스는 연결된 컨트롤에 노출되지 않습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

설명

Enable을 TRUE 로 설정하여 이 메서드를 호출하면 PenInputPanel 개체가 연결된 컨트롤에서 TSF를 시작하려고 시도합니다.

EnableTsf 는 PenInputPanel 이 SendInput 함수가 아닌 TSF 삽입 컨텍스트를 사용하여 필기 인식 결과를 컨트롤에 보낼 수 있도록 하는 데 사용해야 합니다. 그 결과 필드에 포커스가 더 이상 없더라도 텍스트를 삽입할 수 있습니다.

값이 TRUE인 EnableTsf를 호출하면 PenInputPanel 개체가 연결된 컨트롤에 EM_SETEDITSTYLE 메시지를 보냅니다. 컨트롤이 이 메시지를 지원하지 않는 경우 결과를 예측할 수 없습니다. InkEdit 컨트롤은 TSF를 지원합니다.

레거시 애플리케이션 지원

데스크톱 전체의 모든 애플리케이션에 일관된 사용자 인터페이스를 제공하기 위해 TSF 및 Microsoft Windows에 지원이 추가되었습니다. 이 새로운 지원을 통해 TSF를 인식하지 못하는 레거시 애플리케이션 또는 컨트롤이 일부 고급 텍스트 서비스를 무료로 활용할 수 있습니다. 예를 들어 이제 음성 받아쓰기 및 필기를 사용하여 모든 애플리케이션의 문서에 텍스트를 입력할 수 있습니다.

이 새로운 기능은 Windows XP 태블릿 PC Edition에서 기본적으로 사용할 수 있으며 사용하도록 설정되어 있습니다. 사용하거나 사용하지 않도록 설정하려면 다음을 수행합니다.

제어판 국가 및 언어 옵션을 클릭합니다.
언어 탭에서 세부 정보를 클릭합니다.
텍스트 서비스 및 입력 언어 대화 상자의 고급 탭에서 고급 텍스트 서비스의 지원 확장을 모든 프로그램에 선택하거나 선택 취소합니다.

성공하면 텍스트가 TSF를 통해 연결된 컨트롤로 전송됩니다. 또한 컨트롤이 TSF를 지원하는 경우(위에서 설명한 대로 고급 텍스트 서비스가 제어판 모든 프로그램에 대해 사용하도록 설정되었다고 해서 단순히 TSF에서 텍스트를 수신하지 않는 경우) 수정 사용자 인터페이스가 컨트롤에 표시되고 필기 대체 항목에 대한 액세스를 허용합니다. Enable을 FALSE 로 설정하여 이 메서드를 호출하면 PenInputPanel 개체가 연결된 컨트롤에서 TSF를 종료하려고 시도합니다.

요구 사항


지원되는 최소 클라이언트	Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	peninputpanel.h
라이브러리	InkObj.dll

추가 정보

IPenInputPanel

PenInputPanel

다음을 통해 공유