PenInputPanel.Width 屬性

已取代。取得畫筆輸入面板的寬度，以用戶端座標表示。PenInputPanel 已被 Microsoft.Ink.TextInput 取代。

命名空間：  Microsoft.Ink
組件：  Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public ReadOnly Property Width As Integer
'用途
Dim instance As PenInputPanel
Dim value As Integer

value = instance.Width

public int Width { get; }

public:
property int Width {
    int get ();
}

/** @property */
public int get_Width()

public function get Width () : int

屬性值

型別：System.Int32
畫筆輸入面板的寬度，以用戶端座標表示。

值	意義
456	像素的數目等於 4.75 英吋，每英吋 96 點 (dpi)。
570	像素的數目等於 4.75 英吋，每英吋 120 dpi。
632	像素的數目等於 4.75 英吋，每英吋 133 dpi。

備註

PenInputPanel 物件的寬度是根據特殊 Tablet PC 的螢幕解析度而定。

自 Microsoft® Windows® XP Tablet PC Edition 2005 起，[Tablet PC 輸入面板] 透過自動增加 [輸入面板] 大小以納入新的手寫，讓使用者能夠繼續手寫輸入。Height 和 Width 屬性不會更新，隨 [輸入面板] 擴大反映新的大小。這些屬性會傳回 [輸入面板] 的原始大小。同時也不會回報停留於 [輸入面板] 目標時效果的維度。

安全性注意事項：
如果在部分信任的情況下使用，除了 PenInputPanel 所需的權限之外，這個屬性還需要 SecurityPermissionFlag.AllFlags (英文) 權限。如需詳細資訊，請參閱Security and Trust。

範例

這個 C# 範例會建立 PenInputPanel 物件 thePenInputPanel，並且將它附加至 InkEdit 控制項 inkEdit1。接著會附加名為 VisibleChanged_Event 的 VisibleChanged 事件處理常式。在事件處理常式中，範例會將一個句子加入至 PenInputPanel 所附加之編輯控制項的內容。這個句子會透過擷取 Width 屬性並且使用 ToString (英文) 方法將它轉換成字串，表示畫筆輸入面板的寬度 (以像素為單位)。

[C#]

//...

// Delcare 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(inkEdit1);

    // 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;

        // When the panel has become visible...
        if (e.NewVisibility)
        {
            // Display the width of the panel in the attached edit control
            theSenderPanel.AttachedEditControl.Text +=
                    "The width of the panel is ";
            theSenderPanel.AttachedEditControl.Text +=
                     theSenderPanel.Width.ToString();
            theSenderPanel.AttachedEditControl.Text += " pixels.\n";
        }
    }
}

這個 Microsoft Visual Basic® .NET 範例會建立 PenInputPanel 物件 thePenInputPanel，並且將它附加至 InkEdit 控制項 InkEdit1。接著會附加名為 VisibleChanged_Event 的 VisibleChanged 事件處理常式。在事件處理常式中，範例會將一個句子加入至 PenInputPanel 所附加之編輯控制項的內容。這個句子會透過擷取 Width 屬性並且使用 ToString (英文) 方法將它轉換成字串，表示畫筆輸入面板的寬度 (以像素為單位)。

[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(InkEdit1)

    ' 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)

       ' When the panel has become visible...
       If e.NewVisibility Then
          ' Display the width of the panel in the attached edit control
          theSenderPanel.AttachedEditControl.Text += _
                   "The width of the panel is "

          theSenderPanel.AttachedEditControl.Text += _
                   theSenderPanel.Width.ToString()

         theSenderPanel.AttachedEditControl.Text += _
                  " pixels." + ControlChars.Lf
       End If
    End If
End Sub 'VisibleChanged_Event

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。

版本資訊

.NET Framework

支援版本：3.0

請參閱

參考

PenInputPanel 類別

PenInputPanel 成員

Microsoft.Ink 命名空間

PenInputPanel.Height