PenInputPanel.CurrentPanel 속성

아티클
11/04/2008

업데이트: 2007년 11월

사용되지 않습니다. PenInputPanel 개체 내에서 현재 입력에 사용 중인 패널 형식을 가져오거나 설정합니다. PenInputPanel은 Microsoft.Ink.TextInput으로 대체되었습니다.

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

구문

‘선언
Public Property CurrentPanel As PanelType
‘사용 방법
Dim instance As PenInputPanel
Dim value As PanelType

value = instance.CurrentPanel

instance.CurrentPanel = value

public PanelType CurrentPanel { get; set; }

public:
property PanelType CurrentPanel {
    PanelType get ();
    void set (PanelType value);
}

/** @property */
public PanelType get_CurrentPanel()
/** @property */
public  void set_CurrentPanel(PanelType value)

public function get CurrentPanel () : PanelType
public function set CurrentPanel (value : PanelType)

속성 값

형식: Microsoft.Ink.PanelType
PenInputPanel 개체 내에서 현재 입력에 사용 중인 패널 형식을 나타내는 PanelType 값 중 하나입니다. 기본값은 Handwriting 패널 형식입니다.

설명

참고

CurrentPanel 속성은 Default 또는 Inactive로 설정할 수 없습니다.

PenInputPanel 개체를 만들면 Handwriting 패널(필기판이라고도 함)이 기본 입력 UI가 됩니다.

PenInputPanel 개체가 처음으로 활성화되기 전에 CurrentPanel 속성을 설정하여 패널을 변경하면 PanelChanged 이벤트가 발생합니다.

CurrentPanel 속성은 PanelType 열거형의 Handwriting 또는 Keyboard 값으로만 설정할 수 있습니다. CurrentPanel 속성은 Default 또는 Inactive로 설정할 수 없습니다.

패널 창이 PenInputPanel 개체의 다른 인스턴스에 연결되어 있는 경우 CurrentPanel 속성은 Inactive 열거형 값을 반환합니다. 패널이 비활성화되어 있거나 패널 형식이 잘못된 경우 CurrentPanel 속성을 설정하면 예외가 발생합니다.

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

예제

이 C# 예제에서는 PenInputPanel 개체인 thePenInputPanel을 만들어 InkEdit 컨트롤인 theInkEdit에 연결합니다. 그런 다음 thePenInputPanel에 VisibleChanged 이벤트 처리기인 VisibleChanged_Event를 연결합니다. 이벤트 처리기는 키보드 패널이 나타날 때마다 CurrentPanel 속성을 Keyboard로 설정하여 펜 입력 패널이 키보드 패널을 표시하도록 합니다.

[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 VisibleChanged 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)
        {
            // Always default to keyboard input
            if (theSenderPanel.CurrentPanel == PanelType.Handwriting)
            {
                theSenderPanel.CurrentPanel = PanelType.Keyboard;
            }
        }
    }
}

이 Microsoft® Visual Basic® .NET 예제에서는 PenInputPanel 개체인 thePenInputPanel을 만들어 InkEdit 컨트롤인 theInkEdit에 연결합니다. 그런 다음 thePenInputPanel에 VisibleChanged 이벤트 처리기인 VisibleChanged_Event를 연결합니다. 이벤트 처리기는 키보드 패널이 나타날 때마다 CurrentPanel 속성을 Keyboard로 설정하여 펜 입력 패널이 키보드 패널을 표시하도록 합니다.

[Visual Basic]

'...

' Declare the PenInputPanel object
Dim thePenInputPanel As PenInputPanel

Public Sub New()
    MyBase.New()

    ' Required for Windows Form Designer support
    InitializeComponent()

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

    ' Add a VisibleChanged 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
          ' Always default to keyboard input
          If theSenderPanel.CurrentPanel = PanelType.Handwriting Then
             theSenderPanel.CurrentPanel = PanelType.Keyboard
          End If
       End If
    End If
End Sub 'VisibleChanged_Event