PenInputPanel.CommitPendingInput 메서드

아티클
11/04/2008

업데이트: 2007년 11월

사용되지 않습니다. 수집된 잉크를 인식기로 보내고 인식 결과를 게시합니다. PenInputPanel은 Microsoft.Ink.TextInput으로 대체되었습니다.

네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
Public Sub CommitPendingInput
‘사용 방법
Dim instance As PenInputPanel

instance.CommitPendingInput()

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
public void CommitPendingInput()

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
public:
void CommitPendingInput()

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true) */
public void CommitPendingInput()

public function CommitPendingInput()

설명

서양 언어의 경우 필기 패널에서 수집된 잉크를 인식기로 보내고 필기판을 지웁니다. 여러 개의 상자를 사용하는 동아시아 언어의 경우에는 필기 패널에서 인식된 문자를 보내고 상자를 지웁니다. 인식 결과는 PenInputPanel 개체가 연결된 컨트롤로 보내집니다.

보류 중인 입력이 없거나 CurrentPanel 속성이 Keyboard이면 CommitPendingInput은 아무런 작업을 수행하지 않습니다.

PenInputPanel 개체가 비활성화된 상태에서 이 메서드를 호출하면 오류가 생성됩니다.

Microsoft® Windows® XP Tablet PC Edition 2005부터 잉크는 사용자 입력과 동시에 인식됩니다. 그러므로 CommitPendingInput 함수는 이미 인식된 텍스트를 편집 컨트롤로 보내며 인식이 강제로 수행되지 않습니다.

Windows XP Tablet PC Edition 2005부터는 PenInputPanel 개체가 비활성 상태이면 CommitPendingInput은 오류를 생성하지 않고 되돌아옵니다.

보안 정보:
부분 신뢰 환경에서 사용하는 경우 이 메서드에 SecurityPermissionFlag.AllFlags 권한 및 PenInputPanel에서 요구하는 권한이 필요합니다. 자세한 내용은 Security and Trust를 참조하십시오.

예제

이 C# 예제에서는 PenInputPanel 개체인 thePenInputPanel을 만들어 InkEdit 컨트롤인 theInkEdit에 연결합니다. 그런 다음 VisibleChanged 이벤트 처리기인 VisibleChanged_Event를 PenInputPanel의 폼에 추가합니다. 이벤트 처리기에서 PenInputPanel 개체가 표시되지 않으면 CommitPendingInput 메서드를 호출하여 보류 중인 입력을 인식기로 보냅니다.

[C#]

//...

// Declare the PenInputPanel object
PenInputPanel thePenInputPanel;

public Form1()
{
    // Required for Windows Form Designer support
    InitializeComponent();

    // Create and attach the new PenInputPanel to an InkEdit control.
    thePenInputPanel = new PenInputPanel(theInkEdit);

    // Add a PenInputPanelVisibleChanged event handler
    thePenInputPanel.VisibleChanged +=
        new PenInputPanelVisibleChangedEventHandler(VisibleChanged_Event);
}

//...

public void VisibleChanged_Event(object sender,
PenInputPanelVisibleChangedEventArgs e)
{
    // Make sure the object that generated
    // the event is a PenInputPanel object
    if (sender is PenInputPanel)
    {
        PenInputPanel theSenderPanel = (PenInputPanel)sender;

        // If the panel has become invisible...
        if (!e.NewVisibility)
        {
            // Send pending input to the recognizer
            theSenderPanel.CommitPendingInput();
        }
    }
}

이 Microsoft Visual Basic® .NET 예제에서는 PenInputPanel 개체인 thePenInputPanel을 만들어 InkEdit 컨트롤인 theInkEdit에 연결합니다. 그런 다음 VisibleChanged 이벤트 처리기인 VisibleChanged_Event를 PenInputPanel의 폼에 추가합니다. 이벤트 처리기에서 PenInputPanel 개체가 표시되지 않으면 CommitPendingInput 메서드를 호출하여 보류 중인 입력을 인식기로 보냅니다.

[Visual Basic]

'...

' Declare the PenInputPanel object
Dim thePenInputPanel As PenInputPanel

Public Sub New()
    MyBase.New()

    'This call is required by the Windows Form Designer.
    InitializeComponent()

    ' Create and attach the new PenInputPanel to an InkEdit control.
    thePenInputPanel = New PenInputPanel(theInkEdit)

    ' Add a PenInputPanelVisibleChanged event handler
    AddHandler thePenInputPanel.VisibleChanged, _
               AddressOf VisibleChanged_Event
End Sub 'New

'...

Public Sub VisibleChanged_Event(sender As Object, e As _
                                PenInputPanelVisibleChangedEventArgs)
    ' Make sure the object that generated
    ' the event is a PenInputPanel object
    If TypeOf sender Is PenInputPanel Then
       Dim theSenderPanel As PenInputPanel = CType(sender, PenInputPanel)

       ' If the panel has become invisible...
       If Not e.NewVisibility Then
          ' Send pending input to the recognizer
            theSenderPanel.CommitPendingInput()
       End If
    End If
End Sub 'VisibleChanged_Event