GtkSource.CompletionProposal¶

Implementations:: GtkSource.CompletionItem

Methods¶

	`changed` ()
	`equal` (other)
	`get_gicon` ()
	`get_icon` ()
	`get_icon_name` ()
	`get_info` ()
	`get_label` ()
	`get_markup` ()
	`get_text` ()
	`hash` ()

Virtual Methods¶

	`do_changed` ()
	`do_equal` (other)
	`do_get_gicon` ()
	`do_get_icon` ()
	`do_get_icon_name` ()
	`do_get_info` ()
	`do_get_label` ()
	`do_get_markup` ()
	`do_get_text` ()
	`do_hash` ()

Properties¶

None

Signals¶

Name	Short Description
`changed`	Emitted when the proposal has changed.

Fields¶

None

Class Details¶

class GtkSource.CompletionProposal¶

Bases:: GObject.GInterface
Structure:: GtkSource.CompletionProposalIface

changed()¶: Emits the “changed” signal on self. This should be called by implementations whenever the name, icon or info of the proposal has changed.

equal(other)¶

Parameters:: other (GtkSource.CompletionProposal) – a GtkSource.CompletionProposal.
Returns:: True if self and object are the same proposal
Return type:: bool

Get whether two proposal objects are the same. This is used to (together with GtkSource.CompletionProposal.hash()) to match proposals in the completion model. By default, it uses direct equality (GLib.direct_equal()).

get_gicon()¶

Returns:: A Gio.Icon with the icon of self.
Return type:: Gio.Icon or None

Gets the Gio.Icon for the icon of self.

New in version 3.18.

get_icon()¶

Returns:: A GdkPixbuf.Pixbuf with the icon of self.
Return type:: GdkPixbuf.Pixbuf or None

Gets the GdkPixbuf.Pixbuf for the icon of self.

get_icon_name()¶

Returns:: The icon name of self.
Return type:: str or None

Gets the icon name of self.

New in version 3.18.

get_info()¶

Returns:: a newly-allocated string containing extra information of self or None if no extra information is associated to self.
Return type:: str or None

Gets extra information associated to the proposal. This information will be used to present the user with extra, detailed information about the selected proposal. The returned string must be freed with GLib.free().

get_label()¶

Returns:: a new string containing the label of self.
Return type:: str

Gets the label of self. The label is shown in the list of proposals as plain text. If you need any markup (such as bold or italic text), you have to implement GtkSource.CompletionProposal.get_markup(). The returned string must be freed with GLib.free().

get_markup()¶

Returns:: a new string containing the label of self with markup.
Return type:: str

Gets the label of self with markup. The label is shown in the list of proposals and may contain markup. This will be used instead of GtkSource.CompletionProposal.get_label() if implemented. The returned string must be freed with GLib.free().

get_text()¶

Returns:: a new string containing the text of self.
Return type:: str

Gets the text of self. The text that is inserted into the text buffer when the proposal is activated by the default activation. You are free to implement a custom activation handler in the provider and not implement this function. For more information, see GtkSource.CompletionProvider.activate_proposal(). The returned string must be freed with GLib.free().

hash()¶

Returns:: The hash value of self.
Return type:: int

Get the hash value of self. This is used to (together with GtkSource.CompletionProposal.equal()) to match proposals in the completion model. By default, it uses a direct hash (GLib.direct_hash()).

do_changed() virtual¶: Emits the “changed” signal on proposal. This should be called by implementations whenever the name, icon or info of the proposal has changed.

do_equal(other) virtual¶

Parameters:: other (GtkSource.CompletionProposal) – a GtkSource.CompletionProposal.
Returns:: True if proposal and object are the same proposal
Return type:: bool

Get whether two proposal objects are the same. This is used to (together with GtkSource.CompletionProposal.hash()) to match proposals in the completion model. By default, it uses direct equality (GLib.direct_equal()).

do_get_gicon() virtual¶

Returns:: A Gio.Icon with the icon of proposal.
Return type:: Gio.Icon or None

Gets the Gio.Icon for the icon of proposal.

New in version 3.18.

do_get_icon() virtual¶

Returns:: A GdkPixbuf.Pixbuf with the icon of proposal.
Return type:: GdkPixbuf.Pixbuf or None

Gets the GdkPixbuf.Pixbuf for the icon of proposal.

do_get_icon_name() virtual¶

Returns:: The icon name of proposal.
Return type:: str or None

Gets the icon name of proposal.

New in version 3.18.

do_get_info() virtual¶

Returns:: a newly-allocated string containing extra information of proposal or None if no extra information is associated to proposal.
Return type:: str or None

Gets extra information associated to the proposal. This information will be used to present the user with extra, detailed information about the selected proposal. The returned string must be freed with GLib.free().

do_get_label() virtual¶

Returns:: a new string containing the label of proposal.
Return type:: str

Gets the label of proposal. The label is shown in the list of proposals as plain text. If you need any markup (such as bold or italic text), you have to implement GtkSource.CompletionProposal.get_markup(). The returned string must be freed with GLib.free().

do_get_markup() virtual¶

Returns:: a new string containing the label of proposal with markup.
Return type:: str

Gets the label of proposal with markup. The label is shown in the list of proposals and may contain markup. This will be used instead of GtkSource.CompletionProposal.get_label() if implemented. The returned string must be freed with GLib.free().

do_get_text() virtual¶

Returns:: a new string containing the text of proposal.
Return type:: str

Gets the text of proposal. The text that is inserted into the text buffer when the proposal is activated by the default activation. You are free to implement a custom activation handler in the provider and not implement this function. For more information, see GtkSource.CompletionProvider.activate_proposal(). The returned string must be freed with GLib.free().

do_hash() virtual¶

Returns:: The hash value of proposal.
Return type:: int

Get the hash value of proposal. This is used to (together with GtkSource.CompletionProposal.equal()) to match proposals in the completion model. By default, it uses a direct hash (GLib.direct_hash()).

Signal Details¶

GtkSource.CompletionProposal.signals.changed(completion_proposal)¶

Signal Name:: changed
Flags:: RUN_LAST, ACTION
Parameters:: completion_proposal (GtkSource.CompletionProposal) – The object which received the signal

Emitted when the proposal has changed. The completion popup will react to this by updating the shown information.