#include <entrybuffer.h>

Inheritance diagram for Gtk::EntryBuffer:

Public Member Functions
virtual	~EntryBuffer ()

GtkEntryBuffer *	gobj ()
	Provides access to the underlying C GObject. More...

const GtkEntryBuffer *	gobj () const
	Provides access to the underlying C GObject. More...

GtkEntryBuffer *	gobj_copy ()
	Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...

gsize	get_bytes () const

guint	get_length () const

Glib::ustring	get_text () const

void	set_text (const Glib::ustring &text)

void	set_max_length (int max_length)

int	get_max_length () const

guint	insert_text (guint position, const Glib::ustring &text)

guint	delete_text (guint position, int n_chars)

void	emit_inserted_text (guint position, const Glib::ustring &text)

void	emit_deleted_text (guint position, guint n_chars)

Glib::SignalProxy3< void, guint, const gchar *, guint >	signal_inserted_text ()

Glib::SignalProxy2< void, guint, guint >	signal_deleted_text ()

Glib::PropertyProxy< Glib::ustring >	property_text ()

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_text () const

Glib::PropertyProxy_ReadOnly< guint >	property_length () const

Glib::PropertyProxy< int >	property_max_length ()

Glib::PropertyProxy_ReadOnly< int >	property_max_length () const

Static Public Member Functions
static GType	get_type () G_GNUC_CONST

static Glib::RefPtr< EntryBuffer >	create ()

static Glib::RefPtr< EntryBuffer >	create (const Glib::ustring &text)

Protected Member Functions
	EntryBuffer ()

	EntryBuffer (const Glib::ustring &text)

virtual void	on_inserted_text (guint position, const gchar *chars, guint n_chars)
	This is a default handler for the signal signal_inserted_text(). More...

virtual void	on_deleted_text (guint position, guint n_chars)
	This is a default handler for the signal signal_deleted_text(). More...

Related Functions
(Note that these are not member functions.)
Glib::RefPtr< Gtk::EntryBuffer >	wrap (GtkEntryBuffer *object, bool take_copy=false)

Detailed Description

A Text buffer for the Entry widget.

The EntryBuffer class contains the actual text displayed in an Entry widget.

A single EntryBuffer object can be shared by multiple Entry widgets which will then share the same text content, but not the cursor position, visibility attributes, icon etc.

EntryBuffer may be derived from. Such a derived class might allow text to be stored in an alternate location, such as non-pageable memory, useful in the case of important passwords. Or a derived class could integrate with an application's concept of undo/redo.

Definition at line 68 of file entrybuffer.h.

Constructor & Destructor Documentation

◆ ~EntryBuffer()

virtual Gtk::EntryBuffer::~EntryBuffer ( )

virtual

◆ EntryBuffer() [1/2]

Gtk::EntryBuffer::EntryBuffer ( )

protected

Create a new EntryBuffer object with no text.

◆ EntryBuffer() [2/2]

Gtk::EntryBuffer::EntryBuffer ( const Glib::ustring & text )

explicitprotected

Create a new EntryBuffer object.

Parameters

text	Initial buffer text.

Member Function Documentation

◆ create() [1/2]

static Glib::RefPtr<EntryBuffer> Gtk::EntryBuffer::create ( )

static

Create a new EntryBuffer object with no text.

◆ create() [2/2]

static Glib::RefPtr<EntryBuffer> Gtk::EntryBuffer::create ( const Glib::ustring & text )

static

Create a new EntryBuffer object.

Parameters

text	Initial buffer text.

◆ delete_text()

guint Gtk::EntryBuffer::delete_text	(	guint	position,
		int	n_chars
	)

Deletes a sequence of characters from the buffer. n_chars characters are deleted starting at position. If n_chars is negative, then all characters until the end of the text are deleted.

If position or n_chars are out of bounds, then they are coerced to sane values.

Note that the positions are specified in characters, not bytes.

Parameters

position	Position at which to delete text.
n_chars	Number of characters to delete.

Returns: The number of characters deleted.

◆ emit_deleted_text()

void Gtk::EntryBuffer::emit_deleted_text	(	guint	position,
		guint	n_chars
	)

Used when subclassing Gtk::EntryBuffer

Parameters

position	Position at which text was deleted.
n_chars	Number of characters deleted.

◆ emit_inserted_text()

void Gtk::EntryBuffer::emit_inserted_text	(	guint	position,
		const Glib::ustring &	text
	)

Used when deriving from EntryBuffer.

Parameters

position	Position at which text was inserted.
text	Text that was inserted.

◆ get_bytes()

gsize Gtk::EntryBuffer::get_bytes ( ) const

Retrieves the length in bytes of the buffer. See get_length().

Returns: The byte length of the buffer.

◆ get_length()

guint Gtk::EntryBuffer::get_length ( ) const

Retrieves the length in characters of the buffer.

Returns: The number of characters in the buffer.

◆ get_max_length()

int Gtk::EntryBuffer::get_max_length ( ) const

Retrieves the maximum allowed length of the text in buffer. See set_max_length().

Returns: The maximum allowed number of characters in Gtk::EntryBuffer, or 0 if there is no maximum.

◆ get_text()

Glib::ustring Gtk::EntryBuffer::get_text ( ) const

Retrieves the contents of the buffer.

The memory pointer returned by this call will not change unless this object emits a signal, or is finalized.

Returns: A pointer to the contents of the widget as a string. This string points to internally allocated storage in the buffer and must not be freed, modified or stored.

◆ get_type()

static GType Gtk::EntryBuffer::get_type ( )

static

Get the GType for this class, for use with the underlying GObject type system.

◆ gobj() [1/2]

GtkEntryBuffer* Gtk::EntryBuffer::gobj ( )

inline

Provides access to the underlying C GObject.

Definition at line 107 of file entrybuffer.h.

◆ gobj() [2/2]

const GtkEntryBuffer* Gtk::EntryBuffer::gobj ( ) const

inline

Provides access to the underlying C GObject.

Definition at line 110 of file entrybuffer.h.

◆ gobj_copy()

GtkEntryBuffer* Gtk::EntryBuffer::gobj_copy ( )

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

◆ insert_text()

guint Gtk::EntryBuffer::insert_text	(	guint	position,
		const Glib::ustring &	text
	)

Inserts text into the contents of the buffer, at position position.

Parameters

position	The position at which to insert text.
text	The text to insert into the buffer.

Returns: The number of characters actually inserted.

◆ on_deleted_text()

virtual void Gtk::EntryBuffer::on_deleted_text	(	guint	position,
		guint	n_chars
	)

protectedvirtual

This is a default handler for the signal signal_deleted_text().

◆ on_inserted_text()

virtual void Gtk::EntryBuffer::on_inserted_text	(	guint	position,
		const gchar *	chars,
		guint	n_chars
	)

protectedvirtual

This is a default handler for the signal signal_inserted_text().

◆ property_length()

Glib::PropertyProxy_ReadOnly< guint > Gtk::EntryBuffer::property_length ( ) const

Length of the text currently in the buffer.

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_max_length() [1/2]

Glib::PropertyProxy< int > Gtk::EntryBuffer::property_max_length ( )

Maximum number of characters for this entry. Zero if no maximum.

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_max_length() [2/2]

Glib::PropertyProxy_ReadOnly< int > Gtk::EntryBuffer::property_max_length ( ) const

Maximum number of characters for this entry. Zero if no maximum.

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_text() [1/2]

Glib::PropertyProxy< Glib::ustring > Gtk::EntryBuffer::property_text ( )

The contents of the buffer.

Returns: A PropertyProxy that allows you to get or set the value of the property, or receive notification when the value of the property changes.

◆ property_text() [2/2]

Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::EntryBuffer::property_text ( ) const

The contents of the buffer.

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ set_max_length()

void Gtk::EntryBuffer::set_max_length ( int max_length )

Sets the maximum allowed length of the contents of the buffer. If the current contents are longer than the given length, then they will be truncated to fit.

Parameters

max_length The maximum length of the entry buffer, or 0 for no maximum. (other than the maximum length of entries.) The value passed in will be clamped to the range 0-65536.

◆ set_text()

void Gtk::EntryBuffer::set_text ( const Glib::ustring & text )

Sets the text in the buffer. This is roughly equivalent to calling delete_text() and insert_text().

Parameters

text	The text to set in the buffer.

◆ signal_deleted_text()

Glib::SignalProxy2< void,guint,guint > Gtk::EntryBuffer::signal_deleted_text ( )

Slot Prototype:: void on_my_deleted_text(guint position, guint n_chars)

◆ signal_inserted_text()

Glib::SignalProxy3< void,guint,const gchar*,guint > Gtk::EntryBuffer::signal_inserted_text ( )

Slot Prototype:: void on_my_inserted_text(guint position, const gchar* chars, guint n_chars)

Friends And Related Function Documentation

◆ wrap()

Glib::RefPtr< Gtk::EntryBuffer > wrap	(	GtkEntryBuffer *	object,
		bool	take_copy = `false`
	)

Parameters

object	The C instance.
take_copy	False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns: A C++ instance that wraps this C instance.

The documentation for this class was generated from the following file:

entrybuffer.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Related Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~EntryBuffer()

◆ EntryBuffer() [1/2]

◆ EntryBuffer() [2/2]

Member Function Documentation

◆ create() [1/2]

◆ create() [2/2]

◆ delete_text()

◆ emit_deleted_text()

◆ emit_inserted_text()

◆ get_bytes()

◆ get_length()

◆ get_max_length()

◆ get_text()

◆ get_type()

◆ gobj() [1/2]

◆ gobj() [2/2]

◆ gobj_copy()

◆ insert_text()

◆ on_deleted_text()

◆ on_inserted_text()

◆ property_length()

◆ property_max_length() [1/2]

◆ property_max_length() [2/2]

◆ property_text() [1/2]

◆ property_text() [2/2]

◆ set_max_length()

◆ set_text()

◆ signal_deleted_text()

◆ signal_inserted_text()

Friends And Related Function Documentation

◆ wrap()