TextBox.CandidateWindowBoundsChanged Evento

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Ocorre quando a janela Editor do Método de Entrada (IME) é aberta, atualizada ou fechada.

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

Exemplos

Aqui, um retângulo é colocado abaixo de um TextBox. Quando os limites da janela Editor (IME) do Método de Entrada são alterados, a margem inferior da Caixa de Texto é aumentada pela altura da janela candidata do método de entrada Editor (IME). Como resultado, o retângulo é empurrado para baixo por esse valor e não é coberto pela janela 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)
    };
}

Comentários

Para obter dados de evento, consulte CandidateWindowBoundsChangedEventArgs.

Às vezes, os usuários inserem texto por meio de um Método de Entrada Editor (IME) que aparece em uma janela logo abaixo de uma caixa de entrada de texto (normalmente para idiomas do Leste Asiático). A janela IME (Método de Entrada Editor) pode abranger partes importantes da interface do usuário do aplicativo que o usuário pode precisar ver ao inserir texto. Esse evento notifica seu aplicativo das coordenadas em que a janela IME (Editor de Método de Entrada) é exibida no momento. Você pode usar essas informações para desenhar sua interface do usuário em um local que não está em conflito com a janela IME (Editor de Método de Entrada).

Você também pode usar a propriedade DesiredCandidateWindowAlignment para especificar um posicionamento preferencial da janela IME (Editor de Método de Entrada) em relação à caixa de entrada de texto.

Confira também

• DesiredCandidateWindowAlignment
• CandidateWindowBoundsChangedEventArgs