RichEditBox.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<RichEditBox, CandidateWindowBoundsChangedEventArgs const&> const& handler) const;

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

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

public event TypedEventHandler<RichEditBox,CandidateWindowBoundsChangedEventArgs> CandidateWindowBoundsChanged;

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

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

<RichEditBox CandidateWindowBoundsChanged="eventhandler" />

Type d'événement

TypedEventHandler<RichEditBox,CandidateWindowBoundsChangedEventArgs>

Exemples

Ici, un rectangle est placé sous un RichEditBox. Lorsque les limites de la fenêtre Rédacteur de la méthode d’entrée (IME) changent, la marge inférieure de RichEditBox est augmentée de la hauteur de la fenêtre candidate Rédacteur de la 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>
        <RichEditBox x:Name="editBox1" Width="300" HorizontalAlignment="Left" 
                 DesiredCandidateWindowAlignment="BottomEdge"
                 CandidateWindowBoundsChanged="OnCandidateWindowBoundsChanged"/>
        <Rectangle Height="100" Width="100" Fill="Red" 
                   HorizontalAlignment="Left"/>
    </StackPanel>
</Grid> 

private void OnCandidateWindowBoundsChanged(RichEditBox sender, CandidateWindowBoundsChangedEventArgs args) 
{ 
    editBox1.Margin = new Thickness 
    { 
        Left = 0, 
        Top = 0, 
        Right = 0, 
        Bottom = Math.Max(0, args.Bounds.Bottom - editBox1.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