PenInputPanel.InputFailed イベント

[アーティクル]
10/28/2008

使用されていません。PenInputPanel オブジェクトがユーザー入力を結合されたオブジェクトに挿入できるようになる前に入力のフォーカスが変化した場合に発生します。PenInputPanel は Microsoft.Ink.TextInput に置き換えられました。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Event InputFailed As PenInputPanelInputFailedEventHandler
'使用
Dim instance As PenInputPanel
Dim handler As PenInputPanelInputFailedEventHandler

AddHandler instance.InputFailed, handler

public event PenInputPanelInputFailedEventHandler InputFailed

public:
 event PenInputPanelInputFailedEventHandler^ InputFailed {
    void add (PenInputPanelInputFailedEventHandler^ value);
    void remove (PenInputPanelInputFailedEventHandler^ value);
}

/** @event */
public void add_InputFailed (PenInputPanelInputFailedEventHandler value)
/** @event */
public void remove_InputFailed (PenInputPanelInputFailedEventHandler value)

JScript では、イベントは使用できません。

解説

イベントハンドラは、このイベントについてのデータを格納している PenInputPanelInputFailedEventArgs 型の引数を受け取ります。

InputFailed イベントは、ユーザー入力が結合されたコントロールに挿入される前にフォーカスが変化した場合に発生します。たとえば、ユーザーが手書きパッドにインクを入力し、認識エンジンが完了する前に別のエディットコントロールをタップした場合、このイベントが発生します。

このイベントに渡されたウィンドウハンドルを使用することにより、このイベントが発生したときにテキストの手動入力を選択できます。

重要 :
Microsoft® Windows® XP Tablet PC Edition 2005 を使用すると、InputFailed イベントは適用されなくなります。テキストは、常にフォーカスが変化する前に挿入されます。

セキュリティに関するメモ :
部分信頼で使用している場合、このイベントには PenInputPanel により必要とされるアクセス許可に加えて、SecurityPermissionFlag.AllFlags アクセス許可が必要です。「Security and Trust」を参照してください。

例

この C# の例では、2 つの PenInputPanel オブジェクト thePenInputPanel1 および thePenInputPanel2 を作成し、それらを TextBox コントロール textBox1 および textBox2 に結合します。この例では、PenInputPanelInputFailedEventHandler、InputFailed_Event を各 PenInputPanel オブジェクトに追加します。イベントハンドラでは、フォーカスが変化した場合、その Text プロパティを設定することにより、テキストが前の TextBox コントロールで設定されます。

//...

// Declare PenInputPanel objects
PenInputPanel thePenInputPanel1;
PenInputPanel thePenInputPanel2;

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

    // Create, and attach new PenInputPanels to a TextBox controls.
    thePenInputPanel1 = new PenInputPanel(textBox1);
    thePenInputPanel2 = new PenInputPanel(textBox2);

    // Add an InputFailed event handler to each PenInputPanel
    thePenInputPanel1.InputFailed +=
        new PenInputPanelInputFailedEventHandler(InputFailed_Event);

    thePenInputPanel2.InputFailed +=
        new PenInputPanelInputFailedEventHandler(InputFailed_Event);
}

//...

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

        // Set the text in the previous control
        theSenderPanel.AttachedEditControl.Text += e.Text;
    }
}

この Microsoft Visual Basic® .NET の例では、2 つの PenInputPanel オブジェクト thePenInputPanel1 および thePenInputPanel2 を作成し、それらを TextBox コントロール textBox1 および textBox2 に結合します。この例では、PenInputPanelInputFailedEventHandler、InputFailed_Event を各 PenInputPanel オブジェクトに追加します。イベントハンドラでは、フォーカスが変化した場合、その Text プロパティを設定することにより、テキストが前の TextBox コントロールで設定されます。

'...

' Declare the PenInputPanel objects
Dim thePenInputPanel1 As PenInputPanel
Dim thePenInputPanel2 As PenInputPanel

Public Sub New()
    MyBase.New()

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

    ' Create and attach new PenInputPanels to a TextBox controls.
    thePenInputPanel1 = New PenInputPanel(TextBox1)
    thePenInputPanel2 = New PenInputPanel(TextBox2)

    ' Add an InputFailed event handler to each PenInputPanel
    AddHandler thePenInputPanel1.InputFailed, AddressOf InputFailed_Event
    AddHandler thePenInputPanel2.InputFailed, AddressOf InputFailed_Event
End Sub 'New

'...

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

        ' Set the text in the previous control
        thePenInputPanel.AttachedEditControl.Text += e.Text
    End If
End Sub 'InputFailed_Event