RecognizerGuide.Columns プロパティ

2008-10-28

認識ガイドボックスの列の数を取得または設定します。

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

構文

'宣言
Public Property Columns As Integer
'使用
Dim instance As RecognizerGuide
Dim value As Integer

value = instance.Columns

instance.Columns = value

public int Columns { get; set; }

public:
property int Columns {
    int get ();
    void set (int value);
}

/** @property */
public int get_Columns()
/** @property */
public  void set_Columns(int value)

public function get Columns () : int
public function set Columns (value : int)

プロパティ値

型 : System.Int32
ガイドボックスの列の数。

解説

列の幅は、描画ボックスのサイズにより決まります。描画ボックスを取得または設定するには、DrawnBox プロパティを使用します。

Columns プロパティおよび Rows プロパティの値を使用して、使用する認識入力の種類を制御します。Columns および Rows の両方が 0 より大きい場合、ボックス入力が使用されます。可能な入力モードと、各モードの Columns プロパティと Rows プロパティに設定する値を次の表に示します。

入力の種類	Rows に設定する値	Columns プロパティに設定する値
自由入力	0	0
1 本の縦線の入力	0	1
n 本の縦線の入力	0	n
1 本の横線の入力	1	0
n 本の横線の入力	n	0
1 個のボックス入力	1	1
n 個の 1 列のボックス入力	1	n
x 行 z 列のボックスで構成されるグリッドのボックス入力	x	z

例

この例では、RecognizerContext オブジェクトがインスタンス化され、新しい RecognizerGuide オブジェクトを作成することによって Guide プロパティに割り当てられます。

' create a new RecognizerContext object
mRecognizerContext = New RecognizerContext()
' if the Recognizer supports LinedInput, set the Guide
If (mRecognizerContext.Recognizer.Capabilities And RecognizerCapabilities.LinedInput) <> 0 Then
    ' get the lower right corner in pixel units
    Dim lowerRight As Point = New Point(mInkOverlay.AttachedControl.Width, mInkOverlay.AttachedControl.Height)
    ' convert to ink space units
    mInkOverlay.Renderer.PixelToInkSpace(Me.CreateGraphics(), lowerRight)
    ' create Rectangles
    Dim writingBox As Rectangle = New Rectangle(0, 0, lowerRight.X, lowerRight.Y)
    Dim drawnBox As Rectangle = New Rectangle(0, 0, lowerRight.X, lowerRight.Y)
    ' shrink drawn box relative to writing box
    drawnBox.Inflate(-100, -100)
    ' create Guide with 8 rows, zero columns, and no midline
    Dim guide As RecognizerGuide = New RecognizerGuide(8, 0, 0, writingBox, drawnBox)
    mRecognizerContext.Guide = guide
End If

// create a new RecognizerContext object
mRecognizerContext = new RecognizerContext();
// if the Recognizer supports LinedInput, set the Guide
if ((mRecognizerContext.Recognizer.Capabilities & RecognizerCapabilities.LinedInput) != 0)
{
    // get the lower right corner in pixel units
    Point lowerRight = new Point(mInkOverlay.AttachedControl.Width, mInkOverlay.AttachedControl.Height);
    // convert to ink space units
    mInkOverlay.Renderer.PixelToInkSpace(this.CreateGraphics(), ref lowerRight);
    // create Rectangles
    Rectangle writingBox = new Rectangle(0, 0, lowerRight.X, lowerRight.Y);
    Rectangle drawnBox = new Rectangle(0, 0, lowerRight.X, lowerRight.Y);
    // shrink drawn box relative to writing box
    drawnBox.Inflate(-100, -100);
    // create Guide with 8 rows, zero columns, and no midline
    RecognizerGuide guide = new RecognizerGuide(8, 0, 0, writingBox, drawnBox);
    mRecognizerContext.Guide = guide;
}