TextBox.CandidateWindowBoundsChanged Événement

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Se produit lorsque la fenêtre de Rédacteur 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 un TextBox. Lorsque les limites de la fenêtre Rédacteur de la méthode d’entrée (IME) changent, la marge inférieure de la zone de texte est augmentée de la hauteur de la fenêtre candidate Rédacteur 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 les données d’événement, consultez CandidateWindowBoundsChangedEventArgs.

Les utilisateurs entrent parfois du texte par le biais d’un Rédacteur de méthode d’entrée (IME) qui s’affiche dans une fenêtre située juste sous une zone de saisie de texte (généralement pour les langues d’Asie de l’Est). La fenêtre Input Method Rédacteur (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 Rédacteur 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 Rédacteur de méthode d’entrée (IME).

Vous pouvez également utiliser la propriété DesiredCandidateWindowAlignment pour spécifier un placement par défaut de la fenêtre IME (Input Method Rédacteur) par rapport à la zone de saisie de texte.

Voir aussi

• DesiredCandidateWindowAlignment
• CandidateWindowBoundsChangedEventArgs