PenInputPanel.DefaultPanel プロパティ

2008-10-28

使用されていません。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 プロパティをキーボードに設定することにより、キーボードをペン入力パネルの既定の入力方法に設定します。

[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® Visual Basic® .NET の例では、PenInputPanel オブジェクト thePenInputPanel を作成し、それを InkEdit コントロール theInkEdit に結合します。次に、DefaultPanel プロパティをキーボードに設定することにより、キーボードをペン入力パネルの既定の入力方法に設定します。

[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