条目¶

条目用于单行文本输入和编辑。

界面指南

激活¶

每当用户按下 Return 键时，条目都会发出 GtkEntry::activate 信号。

GtkWidget *entry = gtk_entry_new ();

// "on_entry_activate" is defined elsewhere
g_signal_connect (entry, "activate", G_CALLBACK (on_entry_activate), NULL);

entry = Gtk.Entry()

# "on_entry_activate" is defined elsewhere
entry.connect("activate", on_entry_activate)

var entry = new Gtk.Entry ();

// "on_entry_activate" is defined elsewhere
entry.activate.connect (on_entry_activate);

const entry = new Gtk.Entry();

// "on_entry_activate" is defined elsewhere
entry.connect("activate", on_entry_activate);

通过设置 GtkEntry:activates-default 属性，条目还可以激活同一窗口中的默认小部件。

GtkWidget *entry = gtk_entry_new ();

gtk_entry_set_activates_default (GTK_ENTRY (entry), TRUE);

entry = Gtk.Entry(activates_default=True)

var entry = new Gtk.Entry () {
    activates_default = true
};

const entry = new Gtk.Entry({
  activates_default: true,
});

缓冲区¶

条目在其内容内部存储在单独的 GtkEntryBuffer 对象中。您可以使用条目缓冲区在不同的条目小部件之间共享内容。

GtkEntryBuffer *buffer = gtk_entry_buffer_new ("Live, Laugh, Love", -1);

// All three entries will show "Live, Laugh, Love"
GtkWidget *live = gtk_entry_new_with_buffer (buffer);
GtkWidget *laugh = gtk_entry_new_with_buffer (buffer);
GtkWidget *love = gtk_entry_new_with_buffer (buffer);

buffer = Gtk.EntryBuffer(text="Live, Laugh, Love")

# All three entries will show "Live, Laugh, Love"
live = Gtk.Entry(buffer=buffer)
laugh = Gtk.Entry(buffer=buffer)
love = Gtk.Entry(buffer=buffer)

var buffer = new Gtk.EntryBuffer ("Live, Laugh, Love");

// All three entries will show "Live, Laugh, Love"
var live = new Gtk.Entry.with_buffer (buffer);
var laugh = new Gtk.Entry.with_buffer (buffer);
var love = new Gtk.Entry.with_buffer (buffer);

const buffer = new Gtk.EntryBuffer({
  text: "Live, Laugh, Love",
});

// All three entries will show "Live, Laugh, Love"
const live = new Gtk.Entry({ buffer });
const laugh = new Gtk.Entry({ buffer });
const love = new Gtk.Entry({ buffer });

组件的常用方法¶

您应该使用 set_input_purpose() 方法来指定文本条目的用途；例如，如果条目仅用于输入电话号码或电子邮件地址。
您应该使用 set_input_hint() 方法来包含有关文本条目内容的更多提示，尤其是在输入法和国际化方面。
如果您想在条目为空且未聚焦时显示提示，可以使用 GtkEntry:placeholder-text 属性。

API 参考¶

在示例中，我们使用了以下类