RichEditBox.CandidateWindowBoundsChanged Evento

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

Se produce cuando se abre, actualiza o cierra la ventana método de entrada Editor (IME).

// 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" />

Tipo de evento

TypedEventHandler<RichEditBox,CandidateWindowBoundsChangedEventArgs>

Ejemplos

Aquí, un rectángulo se coloca debajo de un RichEditBox. Cuando cambian los límites de la ventana método de entrada Editor (IME), el margen inferior del RichEditBox aumenta por el alto de la ventana candidata método de entrada Editor (IME). Como resultado, el rectángulo se inserta en esa cantidad y no está cubierto por la ventana candidata.

<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) 
    };
} 

Comentarios

Para obtener datos de eventos, consulte CandidateWindowBoundsChangedEventArgs.

A veces, los usuarios escriben texto a través de un método de entrada Editor (IME) que se muestra en una ventana justo debajo de un cuadro de entrada de texto (normalmente para idiomas asiáticos orientales). La ventana método de entrada Editor (IME) puede cubrir partes importantes de la interfaz de usuario de la aplicación que el usuario podría necesitar ver al escribir texto. Este evento notifica a la aplicación las coordenadas en las que se muestra actualmente la ventana método de entrada Editor (IME). Puede usar esta información para dibujar la interfaz de usuario en una ubicación que no entre en conflicto con la ventana Método de entrada Editor (IME).

También puede usar la propiedad DesiredCandidateWindowAlignment para especificar una ubicación preferida de la ventana método de entrada Editor (IME) en relación con el cuadro de entrada de texto.

Consulte también

• DesiredCandidateWindowAlignment
• CandidateWindowBoundsChangedEventArgs