InputPanel, classe

Article
08/21/2008

Mise à jour : novembre 2007

Contrôle le panneau SIP (Soft Input Panel) pour entrer des données sur des Pocket PC et d'autres périphériques fonctionnant sous Windows Embedded CE.

Espace de noms : Microsoft.WindowsCE.Forms
Assembly : Microsoft.WindowsCE.Forms (dans Microsoft.WindowsCE.Forms.dll)

Syntaxe

'Déclaration
Public Class InputPanel _
    Inherits Component
'Utilisation
Dim instance As InputPanel

public class InputPanel : Component

public ref class InputPanel : public Component

public class InputPanel extends Component

Notes

Le .NET Compact Framework fournit le composant InputPanel qui permet une implémentation managée du contrôle SIP dans Windows Embedded CE. Lorsque vous créez une application Windows qui cible la plateforme Pocket PC, Visual Studio ajoute automatiquement un composant MainMenu au fichier Form1 dans votre projet. Ce composant ajoute la barre de menus inférieure dotée de l'icône SIP à votre formulaire. L'utilisation du panneau SIP ne requiert aucune programmation ; une simple pression sur l'icône permet à l'utilisateur de l'afficher et de le masquer. Pour programmer le panneau SIP, faites glisser le composant InputPanel de la ToolBox vers le formulaire.

Vous pouvez afficher le panneau SIP par programme à l'aide de la propriété Enabled, obtenir sa taille à l'aide de la propriété Bounds et déterminer la taille de la zone du formulaire qui n'est pas occupée par le panneau SIP à l'aide de la propriété VisibleDesktop. Notez que la propriété Bounds retourne toujours une largeur de 240 pixels et une hauteur de 80 pixels pour les Pocket PC, que le panneau SIP soit activé ou non. L'événement EnabledChanged se produit toutes les fois où le panneau SIP est activé ou désactivé, par l'utilisateur ou par programme. La programmation du panneau SIP sert généralement à repositionner ou redimensionner des contrôles sur le formulaire lorsque le panneau SIP est activé et désactivé.

Topic	Location
Comment : utiliser le composant InputPanel	.NET Compact Framework
Comment : utiliser le composant InputPanel	.NET Compact Framework
Comment : utiliser le composant InputPanel	.NET Compact Framework

Exemples

L'exemple suivant contient une zone de texte sur une page d'un contrôle onglet. Il affiche le panneau SIP lorsque la zone de texte reçoit le focus et utilise l'événement EnabledChanged pour réduire la hauteur du contrôle onglet lorsque le panneau SIP est activé et rétablir la hauteur d'origine lorsque le panneau SIP est désactivé.

Remarque :
Pour réaliser cet exemple, vous devez ajouter une référence dans votre projet à l'espace de noms Microsoft.WindowsCE.Forms.

Private Sub TextBox1_GotFocus(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles TextBox1.GotFocus
 ' Display the SIP.
 ' Note that the EnabledChanged event occurs
 ' whenever the SIP is enabled or disabled.
 InputPanel1.Enabled = True
End Sub
Private Sub InputPanel1_EnabledChanged(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles InputPanel1.EnabledChanged
 If InputPanel1.Enabled = False Then

  ' The SIP is disabled, so set the height of the tab control
  ' to its original height with a variable (TabOriginalHeight),
  ' which is determined during initialization of the form.
  VisibleRect = InputPanel1.VisibleDesktop
  TabControl1.Height = TabOriginalHeight
 Else
  ' The SIP is enabled, so the height of the tab control
  ' is set to the height of the visible desktop area.
  VisibleRect = InputPanel1.VisibleDesktop
  TabControl1.Height = VisibleRect.Height
 End If

 ' The Bounds property always returns a width of 240 and a height of 80
 ' pixels for Pocket PCs, regardless of whether or not the SIP is enabled.
 BoundsRect = InputPanel1.Bounds

 ' Show the VisibleDesktop and Bounds values
 ' on the second tab for demonstration purposes.
       VisibleInfo.Text = String.Format("VisibleDesktop: X = {0}, " _
       & "Y = {1}, Width = {2}, Height = {3}", _
       VisibleRect.X, VisibleRect.Y, _
       VisibleRect.Width, VisibleRect.Height)
       BoundsInfo.Text = String.Format("Bounds: X = {0}, Y = {1}," _
          & "Width = {2}, Height = {3}", BoundsRect.X, BoundsRect.Y, _
          BoundsRect.Width, BoundsRect.Height)
End Sub

private void textBox1_GotFocus(object sender, System.EventArgs e)
{
    // Display the SIP.
    // Note that the EnabledChanged event occurs
    // whenever the SIP is enabled or disabled.
    inputPanel1.Enabled = true;

}
private void inputPanel1_EnabledChanged(object sender, EventArgs e)
{
    if (inputPanel1.Enabled == false)
    {
        // The SIP is disabled, so set the height of the tab control
        // to its original height with a variable (TabOriginalHeight),
        // which is determined during initialization of the form.
        VisibleRect = inputPanel1.VisibleDesktop;
        tabControl1.Height = TabOriginalHeight;
    }
    else
    {
        // The SIP is enabled, so the height of the tab control
        // is set to the height of the visible desktop area.
        VisibleRect = inputPanel1.VisibleDesktop;
        tabControl1.Height = VisibleRect.Height;
    }

    // The Bounds property always returns a width of 240 and a height of 80
    // pixels for Pocket PCs, regardless of whether or not the SIP is enabled.
    BoundsRect = inputPanel1.Bounds;

    // Show the VisibleDestkop and Bounds values
    // on the second tab for demonstration purposes.
    VisibleInfo.Text = String.Format("VisibleDesktop: X = {0}, " +
        "Y = {1}, Width = {2}, Height = {3}", VisibleRect.X,
        VisibleRect.Y, VisibleRect.Width, VisibleRect.Height);
    BoundsInfo.Text = String.Format("Bounds: X = {0}, Y = {1}, " +
        "Width = {2}, Height = {3}", BoundsRect.X, BoundsRect.Y,
        BoundsRect.Width, BoundsRect.Height);
}

Hiérarchie d'héritage

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.WindowsCE.Forms.InputPanel

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Plateformes

Windows CE, Windows Mobile pour Pocket PC

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.

Informations de version

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

Voir aussi

Référence

Membres InputPanel

Microsoft.WindowsCE.Forms, espace de noms

Partager via