forked from AuroraMiddleware/gtk
d63d9b2319
In many cases, we have an "extra-menu" property that is used to allow applications to join menus into the native menu for the widget. Previously, this was done by nesting that menu in a section. Doing so increases the complexity of the rules for GtkMenuTracker as you may want different handling from inside of the section vs toplevel sections. If instead we synthetically glue the menus together, we have a much more natural joining of menus as the application developer would expect for their menu. This also ports GtkLabel, GtkText, GtkPasswordEntry, and GtkTextView to use the joined menu helper. The joined menu helper comes originally from GNOME Builder and has had extensive use there. Fixes #4094
714 lines
22 KiB
C
714 lines
22 KiB
C
/* GTK - The GIMP Toolkit
|
||
* Copyright (C) 2019 Red Hat, Inc.
|
||
*
|
||
* Authors:
|
||
* - Matthias Clasen <mclasen@redhat.com>
|
||
*
|
||
* This library is free software; you can redistribute it and/or
|
||
* modify it under the terms of the GNU Lesser General Public
|
||
* License as published by the Free Software Foundation; either
|
||
* version 2 of the License, or (at your option) any later version.
|
||
*
|
||
* This library is distributed in the hope that it will be useful,
|
||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
* Lesser General Public License for more details.
|
||
*
|
||
* You should have received a copy of the GNU Lesser General Public
|
||
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
||
*/
|
||
|
||
#include "config.h"
|
||
|
||
#include "gtkpasswordentryprivate.h"
|
||
|
||
#include "gtkaccessibleprivate.h"
|
||
#include "gtktextprivate.h"
|
||
#include "gtkeditable.h"
|
||
#include "gtkeventcontrollerkey.h"
|
||
#include "gtkgestureclick.h"
|
||
#include "gtkbox.h"
|
||
#include "gtkimage.h"
|
||
#include "gtkintl.h"
|
||
#include "gtkmarshalers.h"
|
||
#include "gtkpasswordentrybuffer.h"
|
||
#include "gtkprivate.h"
|
||
#include "gtkwidgetprivate.h"
|
||
#include "gtkcsspositionvalueprivate.h"
|
||
#include "gtkcssnodeprivate.h"
|
||
#include "gtkjoinedmenuprivate.h"
|
||
|
||
|
||
/**
|
||
* GtkPasswordEntry:
|
||
*
|
||
* `GtkPasswordEntry` is an entry that has been tailored for entering secrets.
|
||
*
|
||
* ![An example GtkPasswordEntry](password-entry.png)
|
||
*
|
||
* It does not show its contents in clear text, does not allow to copy it
|
||
* to the clipboard, and it shows a warning when Caps Lock is engaged. If
|
||
* the underlying platform allows it, `GtkPasswordEntry` will also place
|
||
* the text in a non-pageable memory area, to avoid it being written out
|
||
* to disk by the operating system.
|
||
*
|
||
* Optionally, it can offer a way to reveal the contents in clear text.
|
||
*
|
||
* `GtkPasswordEntry` provides only minimal API and should be used with
|
||
* the [iface@Gtk.Editable] API.
|
||
*
|
||
* # CSS Nodes
|
||
*
|
||
* ```
|
||
* entry.password
|
||
* ╰── text
|
||
* ├── image.caps-lock-indicator
|
||
* ┊
|
||
* ```
|
||
*
|
||
* `GtkPasswordEntry` has a single CSS node with name entry that carries
|
||
* a .passwordstyle class. The text Css node below it has a child with
|
||
* name image and style class .caps-lock-indicator for the Caps Lock
|
||
* icon, and possibly other children.
|
||
*
|
||
* # Accessibility
|
||
*
|
||
* `GtkPasswordEntry` uses the %GTK_ACCESSIBLE_ROLE_TEXT_BOX role.
|
||
*/
|
||
|
||
struct _GtkPasswordEntry
|
||
{
|
||
GtkWidget parent_instance;
|
||
|
||
GtkWidget *entry;
|
||
GtkWidget *icon;
|
||
GtkWidget *peek_icon;
|
||
GdkDevice *keyboard;
|
||
GMenuModel *extra_menu;
|
||
};
|
||
|
||
struct _GtkPasswordEntryClass
|
||
{
|
||
GtkWidgetClass parent_class;
|
||
};
|
||
|
||
enum {
|
||
ACTIVATE,
|
||
LAST_SIGNAL
|
||
};
|
||
|
||
static guint signals[LAST_SIGNAL] = { 0, };
|
||
|
||
enum {
|
||
PROP_PLACEHOLDER_TEXT = 1,
|
||
PROP_ACTIVATES_DEFAULT,
|
||
PROP_SHOW_PEEK_ICON,
|
||
PROP_EXTRA_MENU,
|
||
NUM_PROPERTIES
|
||
};
|
||
|
||
static GParamSpec *props[NUM_PROPERTIES] = { NULL, };
|
||
|
||
static void gtk_password_entry_editable_init (GtkEditableInterface *iface);
|
||
static void gtk_password_entry_accessible_init (GtkAccessibleInterface *iface);
|
||
|
||
G_DEFINE_TYPE_WITH_CODE (GtkPasswordEntry, gtk_password_entry, GTK_TYPE_WIDGET,
|
||
G_IMPLEMENT_INTERFACE (GTK_TYPE_ACCESSIBLE, gtk_password_entry_accessible_init)
|
||
G_IMPLEMENT_INTERFACE (GTK_TYPE_EDITABLE, gtk_password_entry_editable_init))
|
||
|
||
static void
|
||
caps_lock_state_changed (GdkDevice *device,
|
||
GParamSpec *pspec,
|
||
GtkWidget *widget)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (widget);
|
||
|
||
if (gtk_editable_get_editable (GTK_EDITABLE (entry)) &&
|
||
gtk_widget_has_focus (entry->entry) &&
|
||
!gtk_text_get_visibility (GTK_TEXT (entry->entry)) &&
|
||
gdk_device_get_caps_lock_state (device))
|
||
gtk_widget_show (entry->icon);
|
||
else
|
||
gtk_widget_hide (entry->icon);
|
||
}
|
||
|
||
static void
|
||
focus_changed (GtkWidget *widget)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (widget);
|
||
|
||
if (entry->keyboard)
|
||
caps_lock_state_changed (entry->keyboard, NULL, widget);
|
||
}
|
||
|
||
/*< private >
|
||
* gtk_password_entry_toggle_peek:
|
||
* @entry: a `GtkPasswordEntry`
|
||
*
|
||
* Toggles the text visibility.
|
||
*/
|
||
void
|
||
gtk_password_entry_toggle_peek (GtkPasswordEntry *entry)
|
||
{
|
||
gboolean visibility;
|
||
|
||
visibility = gtk_text_get_visibility (GTK_TEXT (entry->entry));
|
||
gtk_text_set_visibility (GTK_TEXT (entry->entry), !visibility);
|
||
}
|
||
|
||
static void
|
||
visibility_toggled (GObject *object,
|
||
GParamSpec *pspec,
|
||
GtkPasswordEntry *entry)
|
||
{
|
||
if (gtk_text_get_visibility (GTK_TEXT (entry->entry)))
|
||
{
|
||
gtk_image_set_from_icon_name (GTK_IMAGE (entry->peek_icon), "eye-open-negative-filled-symbolic");
|
||
gtk_widget_set_tooltip_text (entry->peek_icon, _("Hide text"));
|
||
}
|
||
else
|
||
{
|
||
gtk_image_set_from_icon_name (GTK_IMAGE (entry->peek_icon), "eye-not-looking-symbolic");
|
||
gtk_widget_set_tooltip_text (entry->peek_icon, _("Show text"));
|
||
}
|
||
|
||
if (entry->keyboard)
|
||
caps_lock_state_changed (entry->keyboard, NULL, GTK_WIDGET (entry));
|
||
}
|
||
|
||
static void
|
||
activate_cb (GtkPasswordEntry *entry)
|
||
{
|
||
g_signal_emit (entry, signals[ACTIVATE], 0);
|
||
}
|
||
|
||
static void
|
||
gtk_password_entry_init (GtkPasswordEntry *entry)
|
||
{
|
||
GtkEntryBuffer *buffer = gtk_password_entry_buffer_new ();
|
||
|
||
entry->entry = gtk_text_new ();
|
||
gtk_text_set_buffer (GTK_TEXT (entry->entry), buffer);
|
||
gtk_text_set_visibility (GTK_TEXT (entry->entry), FALSE);
|
||
gtk_widget_set_parent (entry->entry, GTK_WIDGET (entry));
|
||
gtk_editable_init_delegate (GTK_EDITABLE (entry));
|
||
g_signal_connect_swapped (entry->entry, "notify::has-focus", G_CALLBACK (focus_changed), entry);
|
||
g_signal_connect_swapped (entry->entry, "activate", G_CALLBACK (activate_cb), entry);
|
||
|
||
entry->icon = gtk_image_new_from_icon_name ("caps-lock-symbolic");
|
||
gtk_widget_set_tooltip_text (entry->icon, _("Caps Lock is on"));
|
||
gtk_widget_add_css_class (entry->icon, "caps-lock-indicator");
|
||
gtk_widget_set_cursor (entry->icon, gtk_widget_get_cursor (entry->entry));
|
||
gtk_widget_set_parent (entry->icon, GTK_WIDGET (entry));
|
||
|
||
gtk_widget_add_css_class (GTK_WIDGET (entry), I_("password"));
|
||
|
||
gtk_password_entry_set_extra_menu (entry, NULL);
|
||
|
||
/* Transfer ownership to the GtkText widget */
|
||
g_object_unref (buffer);
|
||
}
|
||
|
||
static void
|
||
gtk_password_entry_realize (GtkWidget *widget)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (widget);
|
||
GdkSeat *seat;
|
||
|
||
GTK_WIDGET_CLASS (gtk_password_entry_parent_class)->realize (widget);
|
||
|
||
seat = gdk_display_get_default_seat (gtk_widget_get_display (widget));
|
||
if (seat)
|
||
entry->keyboard = gdk_seat_get_keyboard (seat);
|
||
|
||
if (entry->keyboard)
|
||
{
|
||
g_signal_connect (entry->keyboard, "notify::caps-lock-state",
|
||
G_CALLBACK (caps_lock_state_changed), entry);
|
||
caps_lock_state_changed (entry->keyboard, NULL, widget);
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_password_entry_dispose (GObject *object)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (object);
|
||
|
||
if (entry->keyboard)
|
||
g_signal_handlers_disconnect_by_func (entry->keyboard, caps_lock_state_changed, entry);
|
||
|
||
if (entry->entry)
|
||
gtk_editable_finish_delegate (GTK_EDITABLE (entry));
|
||
|
||
g_clear_pointer (&entry->entry, gtk_widget_unparent);
|
||
g_clear_pointer (&entry->icon, gtk_widget_unparent);
|
||
g_clear_pointer (&entry->peek_icon, gtk_widget_unparent);
|
||
g_clear_object (&entry->extra_menu);
|
||
|
||
G_OBJECT_CLASS (gtk_password_entry_parent_class)->dispose (object);
|
||
}
|
||
|
||
static void
|
||
gtk_password_entry_set_property (GObject *object,
|
||
guint prop_id,
|
||
const GValue *value,
|
||
GParamSpec *pspec)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (object);
|
||
const char *text;
|
||
|
||
if (gtk_editable_delegate_set_property (object, prop_id, value, pspec))
|
||
{
|
||
if (prop_id == NUM_PROPERTIES + GTK_EDITABLE_PROP_EDITABLE)
|
||
{
|
||
gtk_accessible_update_property (GTK_ACCESSIBLE (entry),
|
||
GTK_ACCESSIBLE_PROPERTY_READ_ONLY, !g_value_get_boolean (value),
|
||
-1);
|
||
}
|
||
return;
|
||
}
|
||
|
||
switch (prop_id)
|
||
{
|
||
case PROP_PLACEHOLDER_TEXT:
|
||
text = g_value_get_string (value);
|
||
gtk_text_set_placeholder_text (GTK_TEXT (entry->entry), text);
|
||
gtk_accessible_update_property (GTK_ACCESSIBLE (entry),
|
||
GTK_ACCESSIBLE_PROPERTY_PLACEHOLDER, text,
|
||
-1);
|
||
break;
|
||
|
||
case PROP_ACTIVATES_DEFAULT:
|
||
if (gtk_text_get_activates_default (GTK_TEXT (entry->entry)) != g_value_get_boolean (value))
|
||
{
|
||
gtk_text_set_activates_default (GTK_TEXT (entry->entry), g_value_get_boolean (value));
|
||
g_object_notify_by_pspec (object, pspec);
|
||
}
|
||
break;
|
||
|
||
case PROP_SHOW_PEEK_ICON:
|
||
gtk_password_entry_set_show_peek_icon (entry, g_value_get_boolean (value));
|
||
break;
|
||
|
||
case PROP_EXTRA_MENU:
|
||
gtk_password_entry_set_extra_menu (entry, g_value_get_object (value));
|
||
break;
|
||
|
||
default:
|
||
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
||
break;
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_password_entry_get_property (GObject *object,
|
||
guint prop_id,
|
||
GValue *value,
|
||
GParamSpec *pspec)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (object);
|
||
|
||
if (gtk_editable_delegate_get_property (object, prop_id, value, pspec))
|
||
return;
|
||
|
||
switch (prop_id)
|
||
{
|
||
case PROP_PLACEHOLDER_TEXT:
|
||
g_value_set_string (value, gtk_text_get_placeholder_text (GTK_TEXT (entry->entry)));
|
||
break;
|
||
|
||
case PROP_ACTIVATES_DEFAULT:
|
||
g_value_set_boolean (value, gtk_text_get_activates_default (GTK_TEXT (entry->entry)));
|
||
break;
|
||
|
||
case PROP_SHOW_PEEK_ICON:
|
||
g_value_set_boolean (value, gtk_password_entry_get_show_peek_icon (entry));
|
||
break;
|
||
|
||
case PROP_EXTRA_MENU:
|
||
g_value_set_object (value, entry->extra_menu);
|
||
break;
|
||
|
||
default:
|
||
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
||
break;
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_password_entry_measure (GtkWidget *widget,
|
||
GtkOrientation orientation,
|
||
int for_size,
|
||
int *minimum,
|
||
int *natural,
|
||
int *minimum_baseline,
|
||
int *natural_baseline)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (widget);
|
||
int icon_min = 0, icon_nat = 0;
|
||
|
||
gtk_widget_measure (entry->entry, orientation, for_size,
|
||
minimum, natural,
|
||
minimum_baseline, natural_baseline);
|
||
|
||
if (entry->icon && gtk_widget_get_visible (entry->icon))
|
||
gtk_widget_measure (entry->icon, orientation, for_size,
|
||
&icon_min, &icon_nat,
|
||
NULL, NULL);
|
||
|
||
if (entry->peek_icon && gtk_widget_get_visible (entry->peek_icon))
|
||
gtk_widget_measure (entry->peek_icon, orientation, for_size,
|
||
&icon_min, &icon_nat,
|
||
NULL, NULL);
|
||
}
|
||
|
||
static void
|
||
gtk_password_entry_size_allocate (GtkWidget *widget,
|
||
int width,
|
||
int height,
|
||
int baseline)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (widget);
|
||
GtkCssStyle *style = gtk_css_node_get_style (gtk_widget_get_css_node (widget));
|
||
int icon_min = 0, icon_nat = 0;
|
||
int peek_min = 0, peek_nat = 0;
|
||
int text_width;
|
||
int spacing;
|
||
|
||
spacing = _gtk_css_position_value_get_x (style->size->border_spacing, 100);
|
||
|
||
if (entry->icon && gtk_widget_get_visible (entry->icon))
|
||
gtk_widget_measure (entry->icon, GTK_ORIENTATION_HORIZONTAL, -1,
|
||
&icon_min, &icon_nat,
|
||
NULL, NULL);
|
||
|
||
if (entry->peek_icon && gtk_widget_get_visible (entry->peek_icon))
|
||
gtk_widget_measure (entry->peek_icon, GTK_ORIENTATION_HORIZONTAL, -1,
|
||
&peek_min, &peek_nat,
|
||
NULL, NULL);
|
||
|
||
text_width = width - (icon_nat + (icon_nat > 0 ? spacing : 0))
|
||
- (peek_nat + (peek_nat > 0 ? spacing : 0));
|
||
|
||
gtk_widget_size_allocate (entry->entry,
|
||
&(GtkAllocation) { 0, 0, text_width, height },
|
||
baseline);
|
||
|
||
if (entry->icon && gtk_widget_get_visible (entry->icon))
|
||
gtk_widget_size_allocate (entry->icon,
|
||
&(GtkAllocation) { text_width + spacing, 0, icon_nat, height },
|
||
baseline);
|
||
|
||
if (entry->peek_icon && gtk_widget_get_visible (entry->peek_icon))
|
||
gtk_widget_size_allocate (entry->peek_icon,
|
||
&(GtkAllocation) { text_width + spacing + icon_nat + (icon_nat > 0 ? spacing : 0), 0, peek_nat, height },
|
||
baseline);
|
||
}
|
||
|
||
static gboolean
|
||
gtk_password_entry_mnemonic_activate (GtkWidget *widget,
|
||
gboolean group_cycling)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (widget);
|
||
|
||
gtk_widget_grab_focus (entry->entry);
|
||
|
||
return TRUE;
|
||
}
|
||
|
||
static void
|
||
gtk_password_entry_class_init (GtkPasswordEntryClass *klass)
|
||
{
|
||
GObjectClass *object_class = G_OBJECT_CLASS (klass);
|
||
GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
|
||
|
||
object_class->dispose = gtk_password_entry_dispose;
|
||
object_class->get_property = gtk_password_entry_get_property;
|
||
object_class->set_property = gtk_password_entry_set_property;
|
||
|
||
widget_class->realize = gtk_password_entry_realize;
|
||
widget_class->measure = gtk_password_entry_measure;
|
||
widget_class->size_allocate = gtk_password_entry_size_allocate;
|
||
widget_class->mnemonic_activate = gtk_password_entry_mnemonic_activate;
|
||
widget_class->grab_focus = gtk_widget_grab_focus_child;
|
||
widget_class->focus = gtk_widget_focus_child;
|
||
|
||
/**
|
||
* GtkPasswordEntry:placeholder-text:
|
||
*
|
||
* The text that will be displayed in the `GtkPasswordEntry`
|
||
* when it is empty and unfocused.
|
||
*/
|
||
props[PROP_PLACEHOLDER_TEXT] =
|
||
g_param_spec_string ("placeholder-text",
|
||
P_("Placeholder text"),
|
||
P_("Show text in the entry when it’s empty and unfocused"),
|
||
NULL,
|
||
GTK_PARAM_READWRITE);
|
||
|
||
/**
|
||
* GtkPasswordEntry:activates-default:
|
||
*
|
||
* Whether to activate the default widget when Enter is pressed.
|
||
*/
|
||
props[PROP_ACTIVATES_DEFAULT] =
|
||
g_param_spec_boolean ("activates-default",
|
||
P_("Activates default"),
|
||
P_("Whether to activate the default widget (such as the default button in a dialog) when Enter is pressed"),
|
||
FALSE,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
/**
|
||
* GtkPasswordEntry:show-peek-icon: (attributes org.gtk.Property.get=gtk_password_entry_get_show_peek_icon org.gtk.Property.set=gtk_password_entry_set_show_peek_icon)
|
||
*
|
||
* Whether to show an icon for revealing the content.
|
||
*/
|
||
props[PROP_SHOW_PEEK_ICON] =
|
||
g_param_spec_boolean ("show-peek-icon",
|
||
P_("Show Peek Icon"),
|
||
P_("Whether to show an icon for revealing the content"),
|
||
FALSE,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
/**
|
||
* GtkPasswordEntry:extra-menu: (attributes org.gtk.Property.get=gtk_password_entry_get_extra_menu org.gtk.Property.set=gtk_password_entry_set_extra_menu)
|
||
*
|
||
* A menu model whose contents will be appended to
|
||
* the context menu.
|
||
*/
|
||
props[PROP_EXTRA_MENU] =
|
||
g_param_spec_object ("extra-menu",
|
||
P_("Extra menu"),
|
||
P_("Model menu to append to the context menu"),
|
||
G_TYPE_MENU_MODEL,
|
||
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
|
||
|
||
g_object_class_install_properties (object_class, NUM_PROPERTIES, props);
|
||
gtk_editable_install_properties (object_class, NUM_PROPERTIES);
|
||
|
||
/**
|
||
* GtkPasswordEntry::activate:
|
||
* @self: The widget on which the signal is emitted
|
||
*
|
||
* Emitted when the entry is activated.
|
||
*
|
||
* The keybindings for this signal are all forms of the Enter key.
|
||
*/
|
||
signals[ACTIVATE] =
|
||
g_signal_new (I_("activate"),
|
||
G_OBJECT_CLASS_TYPE (object_class),
|
||
G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
|
||
0,
|
||
NULL, NULL,
|
||
NULL,
|
||
G_TYPE_NONE, 0);
|
||
|
||
gtk_widget_class_set_css_name (widget_class, I_("entry"));
|
||
gtk_widget_class_set_accessible_role (widget_class, GTK_ACCESSIBLE_ROLE_TEXT_BOX);
|
||
}
|
||
|
||
static GtkEditable *
|
||
gtk_password_entry_get_delegate (GtkEditable *editable)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (editable);
|
||
|
||
return GTK_EDITABLE (entry->entry);
|
||
}
|
||
|
||
static void
|
||
gtk_password_entry_editable_init (GtkEditableInterface *iface)
|
||
{
|
||
iface->get_delegate = gtk_password_entry_get_delegate;
|
||
}
|
||
|
||
static gboolean
|
||
gtk_password_entry_accessible_get_platform_state (GtkAccessible *self,
|
||
GtkAccessiblePlatformState state)
|
||
{
|
||
GtkPasswordEntry *entry = GTK_PASSWORD_ENTRY (self);
|
||
|
||
switch (state)
|
||
{
|
||
case GTK_ACCESSIBLE_PLATFORM_STATE_FOCUSABLE:
|
||
return gtk_widget_get_focusable (GTK_WIDGET (entry->entry));
|
||
case GTK_ACCESSIBLE_PLATFORM_STATE_FOCUSED:
|
||
return gtk_widget_has_focus (GTK_WIDGET (entry->entry));
|
||
case GTK_ACCESSIBLE_PLATFORM_STATE_ACTIVE:
|
||
return FALSE;
|
||
default:
|
||
g_assert_not_reached ();
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_password_entry_accessible_init (GtkAccessibleInterface *iface)
|
||
{
|
||
GtkAccessibleInterface *parent_iface = g_type_interface_peek_parent (iface);
|
||
iface->get_at_context = parent_iface->get_at_context;
|
||
iface->get_platform_state = gtk_password_entry_accessible_get_platform_state;
|
||
}
|
||
|
||
/*< private >
|
||
* gtk_password_entry_get_text_widget
|
||
* @entry: a `GtkPasswordEntry`
|
||
*
|
||
* Retrieves the `GtkText` delegate of the `GtkPasswordEntry`.
|
||
*
|
||
* Returns: (transfer none): the `GtkText` delegate widget
|
||
*/
|
||
GtkText *
|
||
gtk_password_entry_get_text_widget (GtkPasswordEntry *entry)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_PASSWORD_ENTRY (entry), NULL);
|
||
|
||
return GTK_TEXT (entry->entry);
|
||
}
|
||
|
||
/**
|
||
* gtk_password_entry_new:
|
||
*
|
||
* Creates a `GtkPasswordEntry`.
|
||
*
|
||
* Returns: a new `GtkPasswordEntry`
|
||
*/
|
||
GtkWidget *
|
||
gtk_password_entry_new (void)
|
||
{
|
||
return GTK_WIDGET (g_object_new (GTK_TYPE_PASSWORD_ENTRY, NULL));
|
||
}
|
||
|
||
/**
|
||
* gtk_password_entry_set_show_peek_icon: (attributes org.gtk.Method.set_property=show-peek-icon)
|
||
* @entry: a `GtkPasswordEntry`
|
||
* @show_peek_icon: whether to show the peek icon
|
||
*
|
||
* Sets whether the entry should have a clickable icon
|
||
* to reveal the contents.
|
||
*
|
||
* Setting this to %FALSE also hides the text again.
|
||
*/
|
||
void
|
||
gtk_password_entry_set_show_peek_icon (GtkPasswordEntry *entry,
|
||
gboolean show_peek_icon)
|
||
{
|
||
g_return_if_fail (GTK_IS_PASSWORD_ENTRY (entry));
|
||
|
||
show_peek_icon = !!show_peek_icon;
|
||
|
||
if (show_peek_icon == (entry->peek_icon != NULL))
|
||
return;
|
||
|
||
if (show_peek_icon)
|
||
{
|
||
GtkGesture *press;
|
||
|
||
entry->peek_icon = gtk_image_new_from_icon_name ("eye-not-looking-symbolic");
|
||
gtk_widget_set_tooltip_text (entry->peek_icon, _("Show text"));
|
||
gtk_widget_set_parent (entry->peek_icon, GTK_WIDGET (entry));
|
||
|
||
press = gtk_gesture_click_new ();
|
||
g_signal_connect_swapped (press, "released",
|
||
G_CALLBACK (gtk_password_entry_toggle_peek), entry);
|
||
gtk_widget_add_controller (entry->peek_icon, GTK_EVENT_CONTROLLER (press));
|
||
|
||
g_signal_connect (entry->entry, "notify::visibility",
|
||
G_CALLBACK (visibility_toggled), entry);
|
||
visibility_toggled (G_OBJECT (entry->entry), NULL, entry);
|
||
}
|
||
else
|
||
{
|
||
g_clear_pointer (&entry->peek_icon, gtk_widget_unparent);
|
||
gtk_text_set_visibility (GTK_TEXT (entry->entry), FALSE);
|
||
g_signal_handlers_disconnect_by_func (entry->entry,
|
||
visibility_toggled,
|
||
entry);
|
||
}
|
||
|
||
if (entry->keyboard)
|
||
caps_lock_state_changed (entry->keyboard, NULL, GTK_WIDGET (entry));
|
||
|
||
g_object_notify_by_pspec (G_OBJECT (entry), props[PROP_SHOW_PEEK_ICON]);
|
||
}
|
||
|
||
/**
|
||
* gtk_password_entry_get_show_peek_icon: (attributes org.gtk.Method.get_property=show-peek-icon)
|
||
* @entry: a `GtkPasswordEntry`
|
||
*
|
||
* Returns whether the entry is showing an icon to
|
||
* reveal the contents.
|
||
*
|
||
* Returns: %TRUE if an icon is shown
|
||
*/
|
||
gboolean
|
||
gtk_password_entry_get_show_peek_icon (GtkPasswordEntry *entry)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_PASSWORD_ENTRY (entry), FALSE);
|
||
|
||
return entry->peek_icon != NULL;
|
||
}
|
||
|
||
/**
|
||
* gtk_password_entry_set_extra_menu: (attributes org.gtk.Method.set_property=extra-menu)
|
||
* @entry: a `GtkPasswordEntry`
|
||
* @model: (nullable): a `GMenuModel`
|
||
*
|
||
* Sets a menu model to add when constructing
|
||
* the context menu for @entry.
|
||
*/
|
||
void
|
||
gtk_password_entry_set_extra_menu (GtkPasswordEntry *entry,
|
||
GMenuModel *model)
|
||
{
|
||
GtkJoinedMenu *joined;
|
||
GMenu *menu;
|
||
GMenu *section;
|
||
GMenuItem *item;
|
||
|
||
g_return_if_fail (GTK_IS_PASSWORD_ENTRY (entry));
|
||
|
||
/* bypass this check for the initial call from init */
|
||
if (entry->extra_menu)
|
||
{
|
||
if (!g_set_object (&entry->extra_menu, model))
|
||
return;
|
||
}
|
||
|
||
joined = gtk_joined_menu_new ();
|
||
menu = g_menu_new ();
|
||
|
||
section = g_menu_new ();
|
||
item = g_menu_item_new (_("_Show Text"), "misc.toggle-visibility");
|
||
g_menu_item_set_attribute (item, "touch-icon", "s", "eye-not-looking-symbolic");
|
||
g_menu_append_item (section, item);
|
||
g_object_unref (item);
|
||
|
||
g_menu_append_section (menu, NULL, G_MENU_MODEL (section));
|
||
g_object_unref (section);
|
||
|
||
gtk_joined_menu_append_menu (joined, G_MENU_MODEL (menu));
|
||
g_object_unref (menu);
|
||
|
||
if (model)
|
||
gtk_joined_menu_append_menu (joined, model);
|
||
|
||
gtk_text_set_extra_menu (GTK_TEXT (entry->entry), G_MENU_MODEL (joined));
|
||
|
||
g_object_unref (joined);
|
||
|
||
g_object_notify_by_pspec (G_OBJECT (entry), props[PROP_EXTRA_MENU]);
|
||
}
|
||
|
||
/**
|
||
* gtk_password_entry_get_extra_menu: (attributes org.gtk.Method.get_property=extra-menu)
|
||
* @entry: a `GtkPasswordEntry`
|
||
*
|
||
* Gets the menu model set with gtk_password_entry_set_extra_menu().
|
||
*
|
||
* Returns: (transfer none): (nullable): the menu model
|
||
*/
|
||
GMenuModel *
|
||
gtk_password_entry_get_extra_menu (GtkPasswordEntry *entry)
|
||
{
|
||
return entry->extra_menu;
|
||
}
|