RichEditBox.CandidateWindowBoundsChanged Kejadian

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Terjadi ketika jendela Input Method Editor (IME) terbuka, diperbarui, atau ditutup.

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

Jenis Acara

TypedEventHandler<RichEditBox,CandidateWindowBoundsChangedEventArgs>

Contoh

Di sini, persegi panjang ditempatkan di bawah RichEditBox. Ketika jendela Input Method Editor (IME) berubah, Margin bawah RichEditBox ditingkatkan oleh tinggi jendela kandidat Input Method Editor (IME). Akibatnya, persegi panjang didorong ke bawah oleh jumlah tersebut dan tidak ditutupi oleh jendela kandidat.

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

Keterangan

Untuk data peristiwa, lihat CandidateWindowBoundsChangedEventArgs.

Pengguna terkadang memasukkan teks melalui Editor Metode Input (IME) yang ditampilkan di jendela tepat di bawah kotak input teks (biasanya untuk bahasa Asia Timur). Jendela Editor Metode Input (IME) dapat mencakup bagian penting dari UI aplikasi Anda yang mungkin perlu dilihat pengguna saat memasukkan teks. Kejadian ini memberi tahu aplikasi Anda tentang koordinat tempat jendela Editor Metode Input (IME) saat ini ditampilkan. Anda dapat menggunakan info ini untuk menggambar UI Anda di lokasi yang tidak bertentangan dengan jendela Editor Metode Input (IME).

Anda juga dapat menggunakan properti DesiredCandidateWindowAlignment untuk menentukan penempatan pilihan jendela Editor Metode Input (IME) sehubungan dengan kotak input teks.

Lihat juga

• DesiredCandidateWindowAlignment
• CandidateWindowBoundsChangedEventArgs