InputPanel クラス

[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]

Pocket PC やその他の Windows Embedded CE ベースのデバイス上でデータを入力するためのソフト入力パネル (SIP: Soft Input Panel) を制御します。

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

構文

'宣言
Public Class InputPanel _
    Inherits Component
'使用
Dim instance As InputPanel

public class InputPanel : Component

public ref class InputPanel : public Component

type InputPanel =  
    class
        inherit Component
    end

解説

.NET Compact Framework には、InputPanel コンポーネントが用意されています。これは、Windows Embedded CE で SIP を制御するためのマネージ実装を提供します。Pocket PC プラットフォームを対象とした Windows ベースのアプリケーションを作成する場合、Visual Studio では、プロジェクトの Form1 ファイルに自動的に MainMenu コンポーネントが追加されます。このコンポーネントによって、SIP アイコンを含む下位メニュー バーがフォームに追加されます。SIP を使用するためにプログラミングは必要ありません。ユーザーはアイコンをタップして SIP の表示と非表示を切り替えることができます。SIP をプログラミングするには、InputPanel コンポーネントを ToolBox からフォームにドラッグします。

プログラミングでは、Enabled プロパティを使用して SIP を表示したり、Bounds プロパティを使用して SIP のサイズを取得したり、VisibleDesktop プロパティを使用して SIP で占有されていないフォーム領域のサイズを確認したりできます。Bounds プロパティは、SIP が有効になっているかどうかに関係なく、Pocket PC では常に幅 240 ×高さ 80 ピクセルを返します。ユーザーの操作によるかプログラミングによるかを問わず、SIP が有効または無効になると EnabledChanged イベントが発生します。SIP のプログラミングを利用する一般的な例として、SIP が有効か無効かに応じてフォーム上のコントロールの位置やサイズを変更できます。

注意

Pocket PC デバイスのいくつか返さ、高さ 80 ピクセルより大きい、SIP。高さを決定するのにには、Bounds プロパティを使用します。

Topic	Location
方法 : InputPanel コンポーネントを使用する	.NET Compact Framework
方法 : InputPanel コンポーネントを使用する	.NET Compact Framework
方法 : InputPanel コンポーネントを使用する	.NET Compact Framework
方法 : InputPanel コンポーネントを使用します。	dv_fxnetcf

例

次の例では、タブ コントロールのページ上にテキスト ボックスが含まれています。テキスト ボックスにフォーカスを移動すると、SIP が表示されます。EnabledChanged イベントを使用して、SIP が有効になったらタブ コントロールの高さを低くし、SIP が無効になったら元の高さに戻します。

注意

この例をビルドするには、プロジェクトに Microsoft.WindowsCE.Forms 名前空間への参照を追加する必要があります。

PrivateSub TextBox1_GotFocus(ByVal sender AsObject, _
    ByVal e As System.EventArgs) Handles TextBox1.GotFocus
 ' Display the SIP. ' Note that the EnabledChanged event occurs ' whenever the SIP is enabled or disabled.
 InputPanel1.Enabled = TrueEndSubPrivateSub InputPanel1_EnabledChanged(ByVal sender AsObject, _
    ByVal e As System.EventArgs) Handles InputPanel1.EnabledChanged
 If InputPanel1.Enabled = FalseThen
  ' The SIP is disabled, so set the height of the tab control  ' to its original height with a variable (TabOriginalHeight),  ' which is determined during initialization of the form.
  VisibleRect = InputPanel1.VisibleDesktop
  TabControl1.Height = TabOriginalHeight
 Else  ' The SIP is enabled, so the height of the tab control  ' is set to the height of the visible desktop area.
  VisibleRect = InputPanel1.VisibleDesktop
  TabControl1.Height = VisibleRect.Height
 EndIf
 ' The Bounds property always returns a width of 240 and a height of 80 ' pixels for Pocket PCs, regardless of whether or not the SIP is enabled.
 BoundsRect = InputPanel1.Bounds

 ' Show the VisibleDesktop and Bounds values ' on the second tab for demonstration purposes.
       VisibleInfo.Text = String.Format("VisibleDesktop: X = {0}, " _
       & "Y = {1}, Width = {2}, Height = {3}", _
       VisibleRect.X, VisibleRect.Y, _
       VisibleRect.Width, VisibleRect.Height)
       BoundsInfo.Text = String.Format("Bounds: X = {0}, Y = {1}," _
          & "Width = {2}, Height = {3}", BoundsRect.X, BoundsRect.Y, _
          BoundsRect.Width, BoundsRect.Height)
EndSub

privatevoid textBox1_GotFocus(object sender, System.EventArgs e)
{
    // Display the SIP.// Note that the EnabledChanged event occurs// whenever the SIP is enabled or disabled.
    inputPanel1.Enabled = true;

}
privatevoid inputPanel1_EnabledChanged(object sender, EventArgs e)
{
    if (inputPanel1.Enabled == false)
    {
        // The SIP is disabled, so set the height of the tab control// to its original height with a variable (TabOriginalHeight),// which is determined during initialization of the form.
        VisibleRect = inputPanel1.VisibleDesktop;
        tabControl1.Height = TabOriginalHeight;
    }
    else
    {
        // The SIP is enabled, so the height of the tab control// is set to the height of the visible desktop area.
        VisibleRect = inputPanel1.VisibleDesktop;
        tabControl1.Height = VisibleRect.Height;
    }

    // The Bounds property always returns a width of 240 and a height of 80// pixels for Pocket PCs, regardless of whether or not the SIP is enabled.
    BoundsRect = inputPanel1.Bounds;

    // Show the VisibleDestkop and Bounds values// on the second tab for demonstration purposes.
    VisibleInfo.Text = String.Format("VisibleDesktop: X = {0}, " +
        "Y = {1}, Width = {2}, Height = {3}", VisibleRect.X,
        VisibleRect.Y, VisibleRect.Width, VisibleRect.Height);
    BoundsInfo.Text = String.Format("Bounds: X = {0}, Y = {1}, " +
        "Width = {2}, Height = {3}", BoundsRect.X, BoundsRect.Y,
        BoundsRect.Width, BoundsRect.Height);
}

継承階層

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.WindowsCE.Forms.InputPanel

スレッド セーフ

この型のすべてのパブリック static (Visual Basic では Shared) メンバーは、スレッド セーフです。 インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET フレームワークのシステム要件」を参照してください。

バージョン情報

.NET Compact Framework

サポート対象 : 3.5、2.0、1.0

参照

参照

InputPanel メンバー

Microsoft.WindowsCE.Forms 名前空間