PenInputPanel.Height-Eigenschaft

Artikel
11/26/2008

Veraltet. Ruft die Höhe des Stifteingabebereichs in Clientkoordinaten ab. PenInputPanel wurde durch Microsoft.Ink.TextInput ersetzt.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public ReadOnly Property Height As Integer
'Usage
Dim instance As PenInputPanel
Dim value As Integer

value = instance.Height

public int Height { get; }

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

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

public function get Height () : int

Eigenschaftenwert

Typ: System.Int32
Die Höhe des Stifteingabebereichs in Clientkoordinaten.

Wert	Bedeutung
120	Die Anzahl von Pixeln entspricht 1,25 Zoll bei 96 DPI (Dots Per Inch).
150	Die Anzahl von Pixeln entspricht 1,25 Zoll bei 120 DPI (Dots Per Inch).
166	Die Anzahl von Pixeln entspricht 1,25 Zoll bei 133 DPI (Dots Per Inch).

Hinweise

Die Höhe des Stifteingabebereichs hängt von der Bildschirmauflösung des jeweiligen Tablet PC ab.

Ab Microsoft® Windows® XP Tablet PC Edition 2005 ermöglicht der Tablet PC-Eingabebereich dem Benutzer, die handschriftliche Eingabe fortzusetzen, indem der Eingabebereich automatisch entsprechend den neuen Eingaben vergrößert wird. Die Werte der Height- und der Width-Eigenschaft werden nicht entsprechend der neuen Größe des Eingabebereichs aktualisiert. Diese Eigenschaften geben die ursprüngliche Größe des Eingabebereichs zurück. Sie melden auch nicht die Abmessungen des Hoverziels des Eingabebereichs.

Sicherheitshinweis:
Bei Verwendung mit teilweiser Vertrauenswürdigkeit sind für diese Eigenschaft die SecurityPermissionFlag.AllFlags-Berechtigung sowie die von PenInputPanel geforderten Berechtigungen erforderlich. Weitere Informationen finden Sie unter Security and Trust.

Beispiele

In diesem C#-Beispiel wird das PenInputPanel-Objekt thePenInputPanel erstellt und an das InkEdit-Steuerelement inkEdit1 angefügt. Anschließend wird ein VisibleChanged-Ereignishandler mit dem Namen VisibleChanged_Event angefügt. Im Ereignishandler wird dem Inhalt des Bearbeitungssteuerelements, an das das PenInputPanel angefügt ist, ein Satz hinzugefügt. Dieser Satz nennt die Höhe des Stifteingabebereichs in Pixeln. Dazu wurde der Wert der Height-Eigenschaft abgerufen und mithilfe der ToString-Methode in eine Zeichenfolge umgewandelt.

[C#]

//...

// Declare 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 height of the panel in the attached edit control
            theSenderPanel.AttachedEditControl.Text +=
                    "The height of the panel is ";
            theSenderPanel.AttachedEditControl.Text +=
                     theSenderPanel.Height.ToString();
            theSenderPanel.AttachedEditControl.Text += " pixels.\n";
        }
    }
}

In diesem Microsoft Visual Basic® .NET-Beispiel wird das PenInputPanel-Objekt thePenInputPanel erstellt und an ein InkEdit-Steuerelement mit dem Namen InkEdit1 angefügt. Anschließend wird ein VisibleChanged-Ereignishandler mit dem Namen VisibleChanged_Event angefügt. Im Ereignishandler wird dem Inhalt des Bearbeitungssteuerelements, an das das PenInputPanel angefügt ist, ein Satz hinzugefügt. Dieser Satz nennt die Höhe des Stifteingabebereichs in Pixeln. Dazu wurde der Wert der Height-Eigenschaft abgerufen und mithilfe der ToString-Methode in eine Zeichenfolge umgewandelt.

[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 height of the panel in the attached edit control
          theSenderPanel.AttachedEditControl.Text += _
                   "The height of the panel is "
          theSenderPanel.AttachedEditControl.Text += _
                     theSenderPanel.Height.ToString()
         theSenderPanel.AttachedEditControl.Text += " pixels." + ControlChars.Lf
       End If
    End If
End Sub 'VisibleChanged_Event

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.