TextBox.CandidateWindowBoundsChanged Evento

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Se produce cuando se abre, actualiza o cierra la ventana Editor de métodos de entrada (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 Editor de métodos de entrada (IME), el margen inferior del cuadro de texto aumenta con el alto de la ventana candidata editor de métodos de entrada (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 Editor de métodos de entrada (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 Editor de métodos de entrada (IME) puede abarcar partes importantes de la interfaz de usuario de la aplicación que es posible que el usuario necesite ver al escribir texto. Este evento notifica a la aplicación las coordenadas en las que se muestra actualmente la ventana Editor de métodos de entrada (IME). Puede usar esta información para dibujar la interfaz de usuario en una ubicación que no entre en conflicto con la ventana Editor de métodos de entrada (IME).

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

Consulte también

• DesiredCandidateWindowAlignment
• CandidateWindowBoundsChangedEventArgs