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

Tipo de evento

TypedEventHandler<TextBox,CandidateWindowBoundsChangedEventArgs>

Ejemplos

Aquí, un rectángulo se coloca debajo de un TextBox. Cuando cambian los límites de la ventana método de entrada Editor (IME), el margen inferior del cuadro de texto aumenta por el alto de la ventana candidata del 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>
        <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)
    };
}

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 del Este asiático). 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