RichEditBox.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<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 Éditeur de méthode d’entrée (IME) changent, la marge inférieure de RichEditBox est augmentée de 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>
        <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 é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 informe 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 placement préféré de la fenêtre IME (Input Method Editor) par rapport à la zone de saisie de texte.

Voir aussi

• DesiredCandidateWindowAlignment
• CandidateWindowBoundsChangedEventArgs