PenInputPanel.Refresh-Methode

Artikel
11/26/2008

Veraltet. Aktualisiert basierend auf dem Tablet PC-Eingabebereich die PenInputPanel-Eigenschaften und stellt sie wieder her, positioniert automatisch den Stifteingabebereich und legt die Benutzeroberfläche auf den Standardbereich fest. PenInputPanel wurde durch Microsoft.Ink.TextInput ersetzt.

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

Syntax

'Declaration
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
Public Sub Refresh
'Usage
Dim instance As PenInputPanel

instance.Refresh()

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
public void Refresh()

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
public:
void Refresh()

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true) */
public void Refresh()

public function Refresh()

Hinweise

Die Refresh-Methode stellt den Standardbereich wieder her. Wenn z. B. die DefaultPanel-Eigenschaft auf Keyboard und die CurrentPanel-Eigenschaft auf Handwriting festgelegt ist, legt die Refresh-Methode den Stifteingabebereich auf Keyboard fest. Wenn die DefaultPanel-Eigenschaft auf Default festgelegt ist, ändert die Refresh-Methode den Stifteingabebereich nicht.

Die Refresh-Methode positioniert den Stifteingabebereich automatisch relativ zu dem Steuerelement, dem er zugeordnet ist.

Die Refresh-Methode aktualisiert den Stifteingabebereich mit den Einstellungen des Tablet PC-Eingabebereichs. Sie können beispielsweise Änderungen am PenInputPanel-Objekt vornehmen und dann Refresh aufrufen, um die Einstellungen auf die des Eingabebereichs zurückzusetzen.

Das PenInputPanel-Objekt wird immer dann automatisch aktualisiert, wenn sich die Einstellungen im Eingabebereich ändern.

Wird die Refresh-Methode aufgerufen, ohne dass der Stifteingabebereich den Fokus besitzt , wird ein Fehler generiert.

Hinweis

Normalerweise müssen Sie Refresh nicht aufrufen, weil die entsprechende Funktionalität bereits während der Aktivierung des Stifteingabebereichs angewendet wird. Ist jedoch die AutoShow-Eigenschaft auf false festgelegt, können Sie die Aktivierung des Stifteingabebereichs abschalten. Verwenden Sie in diesem Fall die Refresh-Methode, um das PenInputPanel-Objekt zu aktualisieren.

Hinweis

Ab Microsoft® Windows® XP Tablet PC Edition 2005 ist die Refresh-Methode veraltet und bleibt wirkungslos.

Sicherheitshinweis:
Bei Verwendung mit teilweiser Vertrauenswürdigkeit sind für diese Methode 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 an das InkEdit-Steuerelement theInkEdit angefügt. Fügt dem Formular für das PenInputPanel wird ein VisibleChanged-Ereignishandler mit dem Namen VisibleChanged_Event hinzu. Wenn das PenInputPanel-Objekt sichtbar ist, werden im Ereignishandler dessen Einstellungen auf diejenigen des Eingabebereichs zurückgesetzt, indem die Refresh-Methode aufgerufen wird.

[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(theInkEdit);

    // Add a PenInputPanelVisibleChanged 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;

        // If the panel has become visible...
        if (e.NewVisibility)
        {
            // Restore the pen input panel settings
            // from the global Input Panel
            theSenderPanel.Refresh();
        }
    }
}

In diesem Microsoft Visual Basic .NET-Beispiel wird das PenInputPanel-Objekt thePenInputPanel an das InkEdit-Steuerelement theInkEdit angefügt. Fügt dem Formular für das PenInputPanel wird ein VisibleChanged-Ereignishandler mit dem Namen VisibleChanged_Event hinzu. Wenn das PenInputPanel-Objekt sichtbar ist, werden im Ereignishandler dessen Einstellungen auf diejenigen des Eingabebereichs zurückgesetzt, indem die Refresh-Methode aufgerufen wird.

[Visual Basic]

'...

' Declare the PenInputPanel object
Dim thePenInputPanel As PenInputPanel

Public Sub New()
    MyBase.New()

    'This call is required by the Windows Form Designer.
    InitializeComponent()

    ' Create and attach the new PenInputPanel to an InkEdit control.
    thePenInputPanel = New PenInputPanel(theInkEdit)

    ' Add a PenInputPanelVisibleChanged 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)

       ' If the panel has become visible...
       If e.NewVisibility Then
          ' Restore the pen input panel settings
          ' from the global Input Panel
            theSenderPanel.Refresh()
       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.