TextBox.CandidateWindowBoundsChanged Événement

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Se produit lorsque la fenêtre Éditeur de méthode d’entrée (IME) s’ouvre, se met à jour ou se ferme.

// Register
event_token CandidateWindowBoundsChanged(TypedEventHandler<TextBox, CandidateWindowBoundsChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void CandidateWindowBoundsChanged(event_token const* cookie) const;

// Revoke with event_revoker
TextBox::CandidateWindowBoundsChanged_revoker CandidateWindowBoundsChanged(auto_revoke_t, TypedEventHandler<TextBox, CandidateWindowBoundsChangedEventArgs const&> const& handler) const;

public event TypedEventHandler<TextBox,CandidateWindowBoundsChangedEventArgs> CandidateWindowBoundsChanged;

function onCandidateWindowBoundsChanged(eventArgs) { /* Your code */ }
textBox.addEventListener("candidatewindowboundschanged", onCandidateWindowBoundsChanged);
textBox.removeEventListener("candidatewindowboundschanged", onCandidateWindowBoundsChanged);
- or -
textBox.oncandidatewindowboundschanged = onCandidateWindowBoundsChanged;

Public Custom Event CandidateWindowBoundsChanged As TypedEventHandler(Of TextBox, CandidateWindowBoundsChangedEventArgs) 

<TextBox CandidateWindowBoundsChanged="eventhandler" />

Type d'événement

TypedEventHandler<TextBox,CandidateWindowBoundsChangedEventArgs>

Exemples

Ici, un rectangle est placé sous une zone de texte. Lorsque les limites de la fenêtre Éditeur de méthode d’entrée (IME) changent, la marge inférieure de la zone de texte est augmentée par la hauteur de la fenêtre candidate Éditeur de méthode d’entrée (IME). Par conséquent, le rectangle est poussé vers le bas par ce montant et n’est pas couvert par la fenêtre candidate.

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <StackPanel>
        <TextBox x:Name="textBox1" Width="300" HorizontalAlignment="Left"
                 DesiredCandidateWindowAlignment="BottomEdge"
                 CandidateWindowBoundsChanged="OnCandidateWindowBoundsChanged"/>
        <Rectangle Height="100" Width="100" Fill="Red"
                   HorizontalAlignment="Left"/>
    </StackPanel>
</Grid>

private void OnCandidateWindowBoundsChanged(TextBox sender, CandidateWindowBoundsChangedEventArgs args)
{
    textBox1.Margin = new Thickness
    {
        Left = 0,
        Top = 0,
        Right = 0,
        Bottom = Math.Max(0, args.Bounds.Bottom - textBox1.ActualHeight)
    };
}

Remarques

Pour obtenir des données d’événement, consultez CandidateWindowBoundsChangedEventArgs.

Les utilisateurs entrent parfois du texte via un éditeur de méthode d’entrée (IME) qui s’affiche dans une fenêtre située juste en dessous d’une zone de saisie de texte (généralement pour les langues d’Asie de l’Est). La fenêtre Éditeur de méthode d’entrée (IME) peut couvrir des parties importantes de l’interface utilisateur de votre application que l’utilisateur peut avoir besoin de voir lors de la saisie de texte. Cet événement avertit votre application des coordonnées dans lesquelles la fenêtre Éditeur de méthode d’entrée (IME) est actuellement affichée. Vous pouvez utiliser ces informations pour dessiner votre interface utilisateur dans un emplacement qui n’est pas en conflit avec la fenêtre Éditeur de méthode d’entrée (IME).

Vous pouvez également utiliser la propriété DesiredCandidateWindowAlignment pour spécifier un emplacement préféré de la fenêtre Éditeur de méthode d’entrée (IME) par rapport à la zone de saisie de texte.

Voir aussi

• DesiredCandidateWindowAlignment
• CandidateWindowBoundsChangedEventArgs