Bab 9. Entry

Hampir setiap aplikasi memerlukan masukkan dari penggunanya. Umumnya pengguna memasukkan data teks yang ditulis melalui keyboard. Widget Entry adalah widget yang dapat menerima masukkan seperti ini.

Untuk membuat widget Entry gunakan fungsi :

    gtk.Entry(max=0)
maxpanjang maksimum dari text dalam widget Entry. Jika bernilai 0 berarti tidak ada batas panjang dari text.

Nilai panjang maksimum dari text dapat kita ubah juga dengan fungsi :

    entry.set_max_length(max)

Kita juga dapat menuliskan text ke dalam widget Entry melalui fungsi :

    entry.set_text(text)
textteks yang akan dituliskan ke dalam widget

Fungsi set_text() akan menggantikan tulisan apapun yang telah ada di dalam widget. Widget Entry mengimplementasikan antar-muka (interface) Editable. Maka jika kita ingin menyisipkan suatu teks ke dalam teks yang telah ada dapat digunakan fungsi insert_text().

    entry.insert_text(text,position=0)
textteks yang akan dituliskan ke dalam widget
positionposisi di mana teks akan disisipkan

Sedangkan untuk mengetahui text yang ada di dalam widget Entry dapat digunakan :

    entry.get_text()
kembalianteks yang ada dalam widget

Suatu saat dimana kita ingin Entry tidak dapat menerima input, kita dapat menggunakan fungsi :

    entry.set_editable(is_editable)
is_editableJika kita isi TRUE, Entry dapat di-edit. Jika FALSE maka Entry tidak dapat di-edit.

Misalnya kita memasukkan password ke Entry, tentu saja kita tidak ingin terlihat. Method berikut dapat kita gunakan :

    entry.set_visibility(visible)
visibleJika kita isi TRUE, text akan terlihat seperti biasa. Jika FALSE maka Entry akan mengganti tampilan karakter dengan karakater dari properti "invisible-char", misalnya : karakter '*'. Text aslinya tidak akan berubah.

Sebagian dari text dapat kita select dengan method berikut :

    entry.select_region(start,end)
startAwal selection .
endAkhir selection .

Men-select bagian dari teks. Teks yang di-select dari posisi start sampai sebelum end. Jika end negatif maka akan di-select sampai akhir teks.

Selection ini berguna jika kita ingin 'overwite' text default dari Entry.

Contoh program untuk Label dan Entry dapat dilihat di entry.py . Kurang lebih tampilan programnya akan seperti :

Gambar 9.1. Label dan Entry

Label dan Entry

Cobalah untuk mengubah setting Editable dan Visible serta ukuran windownya. Tekan tombol enter setiap kali menulis ke dalam Entry dan perhatikan output di console.