PenInputPanel.EnableTsf 메서드
업데이트: 2007년 11월
사용되지 않습니다. PenInputPanel 개체가 *TSF(Text Services Framework)*를 통해 연결된 컨트롤로 텍스트를 보내려고 시도하며 수정 사용자 인터페이스를 활성화하는지 여부를 나타냅니다. PenInputPanel은 Microsoft.Ink.TextInput으로 대체되었습니다.
네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)
구문
‘선언
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Sub EnableTsf ( _
enable As Boolean _
)
‘사용 방법
Dim instance As PenInputPanel
Dim enable As Boolean
instance.EnableTsf(enable)
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public void EnableTsf(
bool enable
)
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public:
void EnableTsf(
bool enable
)
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true) */
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public void EnableTsf(
boolean enable
)
public function EnableTsf(
enable : boolean
)
매개 변수
- enable
형식: System.Boolean
PenInputPanel 개체가 TSF(Text Services Framework)를 통해 연결된 컨트롤로 텍스트를 보내려고 시도하며 수정 사용자 인터페이스를 활성화하는지 여부를 나타내는 부울 변수입니다.
true 인 경우 PenInputPanel 개체는 TSF(Text Services Framework)를 통해 연결된 컨트롤로 텍스트를 보내려고 시도하며, 수정 사용자 인터페이스가 활성화됩니다.
false 인 경우에는 PenInputPanel 개체가 연결된 컨트롤에서 TSF를 비활성화하려고 시도하며 수정 사용자 인터페이스를 사용할 수 없습니다.
설명
enable 매개 변수를 true로 설정하여 이 메서드를 호출하면 PenInputPanel 개체가 연결된 컨트롤에서 TSF를 시작하려고 시도합니다.
참고
TSF에 대한 지원이 추가되었으며, 데스크톱 전체에 걸쳐 모든 응용 프로그램에 일관성 있는 사용자 인터페이스가 제공됩니다. 이러한 새로운 지원을 사용하면 TSF를 인식하지 못하는 레거시 응용 프로그램이나 컨트롤에서도 일부 고급 텍스트 서비스를 사용할 수 있습니다. 예를 들어 이제는 음성 받아쓰기 및 필기를 사용하여 응용 프로그램에서 문서에 텍스트를 입력할 수 있습니다.
이 새로운 기능은 Microsoft® Windows® XP Tablet PC Edition에서 기본적으로 사용할 수 있으며 활성화됩니다. 이 기능을 활성화하거나 비활성화하려면 다음을 수행하십시오.
1. 제어판에서 국가 및 언어 옵션을 클릭합니다.
2. 언어 탭에서 자세히를 클릭합니다.
3. 텍스트 서비스 및 입력 언어 대화 상자의 고급 탭에서 모든 프로그램에 고급 텍스트 서비스 지원 확장을 선택하거나 취소합니다.
성공하는 경우 TSF를 통해 연결된 컨트롤로 텍스트를 보냅니다. 또한 컨트롤이 TSF를 지원하며, 이전 절차에서와 같이 TSF로부터 텍스트를 받고 있지 않는 이유가 고급 텍스트 서비스가 활성화되어 있기 때문일 뿐이면 필기 대체 항목에 액세스할 수 있는 수정 사용자 인터페이스가 컨트롤에 나타납니다. enable 매개 변수를 false로 설정하여 이 메서드를 호출하면 PenInputPanel 개체가 연결된 컨트롤에서 TSF를 비활성화하려고 시도합니다.
EnableTsf 메서드를 사용하면 PenInputPanel이 SendInput 함수가 아닌 TSF 삽입 컨텍스트를 사용하여 필기 인식 결과를 컨트롤로 보내도록 할 수 있습니다. PenInputPanel이 TSF 삽입 컨텍스트를 사용하도록 하면 필드에 더 이상 포커스가 없어도 텍스트를 삽입할 수 있습니다.
enable 매개 변수를 true로 설정하여 이 메서드를 호출하면 PenInputPanel 개체가 연결된 컨트롤로 EM_SETEDITSTYLE 메시지를 보냅니다. 컨트롤에서 이 메시지를 지원하지 않는 경우에는 예기치 않은 결과가 발생할 수 있습니다.
InkEdit 컨트롤에서는 TSF를 지원하지 않습니다.
.gif "보안 정보") 보안 정보: |
|---|
부분 신뢰 환경에서 사용하는 경우 이 메서드에 SecurityPermissionFlag.AllFlags 권한 및 PenInputPanel에서 요구하는 권한이 필요합니다. 자세한 내용은 Security and Trust를 참조하십시오. |
예제
이 C# 예제에서는 PenInputPanel 개체인 thePenInputPanel을 InkEdit 컨트롤인 theInkEdit에 연결합니다. EnableTsf 메서드는 PenInputPanel에서 호출되어 TSF를 시작합니다.
[C#]
// Declare, create, and attach a new
// PenInputPanel to an InkEdit control.
PenInputPanel thePenInputPanel = new PenInputPanel(theInkEdit);
// Start the Text Services Framework
thePenInputPanel.EnableTsf(true);
이 Microsoft Visual Basic® .NET 예제에서는 PenInputPanel 개체인 thePenInputPanel을 InkEdit 컨트롤인 theInkEdit에 연결합니다. EnableTsf 메서드는 PenInputPanel에서 호출되어 TSF를 시작합니다.
[Visual Basic]
'Declare, create, and attach a new
'PenInputPanel to an InkEdit control.
Dim thePenInputPanel As New PenInputPanel(theInkEdit)
'Start the Text Services Framework
thePenInputPanel.EnableTsf(True)
플랫폼
Windows Vista
.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.
버전 정보
.NET Framework
3.0에서 지원