PenInputPanel.DefaultPanel 属性

项目
11/04/2008

已否决。获取或设置 PenInputPanel 对象中用于输入的默认面板类型。PenInputPanel 已由 Microsoft.Ink.TextInput 替换。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Property DefaultPanel As PanelType
用法
Dim instance As PenInputPanel
Dim value As PanelType

value = instance.DefaultPanel

instance.DefaultPanel = value

public PanelType DefaultPanel { get; set; }

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

/** @property */
public PanelType get_DefaultPanel()
/** @property */
public  void set_DefaultPanel(PanelType value)

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

属性值

类型：Microsoft.Ink.PanelType
PanelType 值之一。

备注

DefaultPanel 属性不能设置为 Inactive。

Handwriting 面板（也称为手写板）是 PenInputPanel 对象的默认输入 UI。

如果该属性的值是 Default，则在任何应用程序中，PenInputPanel 对象都使用任何笔输入面板所用的最后一个面板类型。如果已在所有活动应用程序中销毁以前对笔输入面板的所有引用，则新的 PenInputPanel 对象使用 Handwriting 面板类型。

如果在 PenInputPanel 对象第一次变为活动之前通过设置 CurrentPanel 属性更改面板，则会发生 PanelChanged 事件。

通过设置 DefaultPanel 属性，可以指定默认情况下在该 PenInputPanel 对象实例中显示的面板类型。如果该属性的值是 Handwriting 或 Keyboard，则每次面板变为可见时，它将分别使用手写或键盘面板类型。

如果将 PenInputPanel 重新附加到其他控件，并在焦点更改到新控件时更改 DefaultPanel 属性，请务必在设置 AttachedEditWindow 属性之前设置 DefaultPanel 属性，以确保显示正确的面板。

安全说明：
如果在部分信任环境下使用，则除了 PenInputPanel 所需的权限以外，该属性还需要 SecurityPermissionFlag.AllFlags 权限。有关更多信息，请参见Security and Trust。

示例

此 C# 示例创建 PenInputPanel 对象 thePenInputPanel，并将它附加到 InkEdit 控件 theInkEdit。然后，它通过将 DefaultPanel 属性设置为 Keyboard，将键盘设置为笔输入面板的默认输入法。

[C#]

//...

// Declare, create, and attach a new PenInputPanel to an InkEdit control
PenInputPanel thePenInputPanel = new PenInputPanel(theInkEdit);

// Set the default panel to keyboard input
thePenInputPanel.DefaultPanel = PanelType.Keyboard;

此 Microsoft(R) Visual Basic(R) .NET 示例创建 PenInputPanel 对象 thePenInputPanel，并将它附加到 InkEdit 控件 theInkEdit。然后，它通过将 DefaultPanel 属性设置为 Keyboard，将键盘设置为笔输入面板的默认输入法。

[Visual Basic]

' Declare, create, and attach a new PenInputPanel to an InkEdit control
Dim thePenInputPanel As New PenInputPanel(theInkEdit)

' Set the default panel to keyboard input
thePenInputPanel.DefaultPanel = PanelType.Keyboard