PenInputPanel.Refresh, méthode

Article
11/05/2008

Mise à jour : November 2007

Désapprouvé. Met à jour et restaure les propriétés PenInputPanel selon le Panneau de saisie Tablet PC, positionne automatiquement le panneau de saisie du stylet et affecte à l'interface utilisateur le panneau par défaut. PenInputPanel a été remplacé par Microsoft.Ink.TextInput.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
Public Sub Refresh
'Utilisation
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()

Notes

La méthode Refresh restaure le panneau par défaut. Par exemple, si la propriété DefaultPanel a la valeur Keyboard et si la propriété CurrentPanel a la valeur Handwriting, la méthode Refresh affecte au panneau de saisie du stylet la valeur Keyboard. Si la propriété DefaultPanel a la valeur Default, la méthode Refresh ne modifie pas le panneau de saisie du stylet.

La méthode Refresh positionne automatiquement le panneau de saisie du stylet en fonction du contrôle auquel il est attaché.

La méthode Refresh met à jour le panneau de saisie du stylet en utilisant les paramètres du Panneau de saisie Tablet PC. Par exemple, vous pouvez modifier l'objet PenInputPanel, puis appeler la méthode Refresh pour restaurer les paramètres copiés dans le Panneau de saisie.

L'objet PenInputPanel est automatiquement mis à jour lorsque les paramètres du Panneau de saisie changent.

L'appel à la méthode Refresh lorsque le panneau de saisie du stylet n'a pas le focus génère une erreur.

Remarque :
Il n'est normalement pas nécessaire d'appeler la méthode Refresh, car les fonctionnalités sont exprimées pendant l'activation du panneau de saisie du stylet. Toutefois, si la propriété AutoShow a la valeur false, vous pouvez désactiver l'activation du panneau de saisie du stylet. Dans ce cas, utilisez la méthode Refresh pour actualiser l'objet PenInputPanel.

Remarque :
Depuis la version Microsoft® Windows® XP Édition Tablet PC 2005, la méthode Refresh est désapprouvée et ne réalise aucune action.

Note de sécurité :
Lors de l'utilisation en situation de confiance partielle, cette méthode requiert l'autorisation SecurityPermissionFlag.AllFlags (page pouvant être en anglais), en plus des autorisations requises par PenInputPanel. Pour plus d'informations, consultez Security and Trust.

Exemples

Cet exemple C# attache un objet PenInputPanel, thePenInputPanel à un contrôle InkEdit, theInkEdit. Il ajoute un gestionnaire d'événements VisibleChanged, VisibleChanged_Event, au formulaire pour PenInputPanel. Dans le gestionnaire d'événements, si l'objet PenInputPanel est visible, les paramètres du Panneau de saisie sont restaurés par l'appel à la méthode Refresh.

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

Cet exemple Microsoft Visual Basic .NET attache un objet PenInputPanel, thePenInputPanel, à un contrôle InkEdit, theInkEdit. Il ajoute un gestionnaire d'événements VisibleChanged, VisibleChanged_Event, au formulaire pour PenInputPanel. Dans le gestionnaire d'événements, si l'objet PenInputPanel est visible, les paramètres du Panneau de saisie sont restaurés par l'appel à la méthode Refresh.

[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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.