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)
| max | panjang 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)
| text | teks 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)
| text | teks yang akan dituliskan ke dalam widget |
| position | posisi di mana teks akan disisipkan |
Sedangkan untuk mengetahui text yang ada di dalam widget Entry dapat digunakan :
entry.get_text()
| kembalian | teks yang ada dalam widget |
Suatu saat dimana kita ingin Entry tidak dapat menerima input, kita dapat menggunakan fungsi :
entry.set_editable(is_editable)
| is_editable | Jika 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)
| visible | Jika 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)
| start | Awal selection . |
| end | Akhir 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 :
Cobalah untuk mengubah setting Editable dan Visible serta ukuran windownya. Tekan tombol enter setiap kali menulis ke dalam Entry dan perhatikan output di console.