PenInputPanel.VisibleChanged イベント

2008-10-28

使用されていません。PenInputPanel オブジェクト自体が表示または非表示になったときに発生します。PenInputPanel は Microsoft.Ink.TextInput に置き換えられました。

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

構文

'宣言
Public Event VisibleChanged As PenInputPanelVisibleChangedEventHandler
'使用
Dim instance As PenInputPanel
Dim handler As PenInputPanelVisibleChangedEventHandler

AddHandler instance.VisibleChanged, handler

public event PenInputPanelVisibleChangedEventHandler VisibleChanged

public:
 event PenInputPanelVisibleChangedEventHandler^ VisibleChanged {
    void add (PenInputPanelVisibleChangedEventHandler^ value);
    void remove (PenInputPanelVisibleChangedEventHandler^ value);
}

/** @event */
public void add_VisibleChanged (PenInputPanelVisibleChangedEventHandler value)
/** @event */
public void remove_VisibleChanged (PenInputPanelVisibleChangedEventHandler value)

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

解説

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

VisibleChanged イベントは、次の場合に発生します。

PenInputPanel オブジェクトのポイント先が、ユーザーインターフェイス (UI) に表示された場合。
PenInputPanel オブジェクト全体の UI が非表示になった場合。

ただし、このイベントは PenInputPanel オブジェクト全体の UI が表示されるまでポイント先が拡張した場合は発生しません。

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

例

この Microsoft® Visual C#® の例では、PenInputPanel オブジェクト thePenInputPanel を作成し、それを InkEdit コントロール theInkEdit に結合します。また、VisibleChanged イベントハンドラ VisibleChanged_Event を PenInputPanel のフォームに追加します。イベントハンドラでは、ペン入力パネルが表示された場合、MoveTo メソッドを呼び出すことによりその位置が画面座標 100, 100 に変更されます。

[C#]

//...

// Delcare 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 visible...
        if (e.NewVisibility)
        {
            // Move the pen input panel to
            // screen position 100, 100
            theSenderPanel.MoveTo(100, 100);
        }
    }
}

この Microsoft Visual Basic® .NET の例では、PenInputPanel オブジェクト thePenInputPanel を作成し、それを InkEdit コントロール theInkEdit に結合します。また、VisibleChanged イベントハンドラ VisibleChanged_Event を PenInputPanel のフォームに追加します。イベントハンドラでは、ペン入力パネルが表示された場合、MoveTo メソッドを呼び出すことによりその位置が画面座標 100, 100 に変更されます。

[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 visible...
       If e.NewVisibility Then
          ' Move the pen input panel to
          ' screen position 100, 100
          theSenderPanel.MoveTo(100, 100)
       End If
    End If
End Sub 'VisibleChanged_Event