GtkSourceCompletionProvider

typedef struct _GtkSourceCompletionProvider GtkSourceCompletionProvider;

struct GtkSourceCompletionProviderIface

struct GtkSourceCompletionProviderIface {
	GTypeInterface g_iface;

	gchar		*(*get_name)       	(GtkSourceCompletionProvider *provider);
	GdkPixbuf *(*get_icon)       	(GtkSourceCompletionProvider *provider);
	void 		 (*populate) 		(GtkSourceCompletionProvider *provider,
						 GtkSourceCompletionContext  *context);

	gboolean 	 (*match)		(GtkSourceCompletionProvider *provider,
	                                         GtkSourceCompletionContext  *context);

	GtkSourceCompletionActivation
		         (*get_activation) (GtkSourceCompletionProvider *provider);

	GtkWidget 	*(*get_info_widget) (GtkSourceCompletionProvider *provider,
						 GtkSourceCompletionProposal *proposal);
	void		 (*update_info)		(GtkSourceCompletionProvider *provider,
						 GtkSourceCompletionProposal *proposal,
						 GtkSourceCompletionInfo     *info);

	gboolean	 (*get_start_iter) (GtkSourceCompletionProvider *provider,
						 GtkSourceCompletionContext  *context,
						 GtkSourceCompletionProposal *proposal,
						 GtkTextIter                 *iter);
	gboolean	 (*activate_proposal) (GtkSourceCompletionProvider *provider,
						 GtkSourceCompletionProposal *proposal,
						 GtkTextIter                 *iter);

	gint		 (*get_interactive_delay) (GtkSourceCompletionProvider *provider);
	gint		 (*get_priority) (GtkSourceCompletionProvider *provider);
};

The virtual function table for GtkSourceCompletionProvider.

gtk_source_completion_provider_get_name ()

gchar *             gtk_source_completion_provider_get_name
                                                        (GtkSourceCompletionProvider *provider);

Get the name of the provider. This should be a translatable name for display to the user. For example: _("Document word completion provider"). The returned string must be freed with g_free().

gtk_source_completion_provider_get_icon ()

GdkPixbuf *         gtk_source_completion_provider_get_icon
                                                        (GtkSourceCompletionProvider *provider);

Get the icon of the provider.

gtk_source_completion_provider_populate ()

void                gtk_source_completion_provider_populate
                                                        (GtkSourceCompletionProvider *provider,
                                                         GtkSourceCompletionContext *context);

Populate context with proposals from provider added with the gtk_source_completion_context_add_proposals() function.

gtk_source_completion_provider_get_activation ()

GtkSourceCompletionActivation gtk_source_completion_provider_get_activation
                                                        (GtkSourceCompletionProvider *provider);

Get with what kind of activation the provider should be activated.

gtk_source_completion_provider_match ()

gboolean            gtk_source_completion_provider_match
                                                        (GtkSourceCompletionProvider *provider,
                                                         GtkSourceCompletionContext *context);

Get whether the provider match the context of completion detailed in context.

gtk_source_completion_provider_get_info_widget ()

GtkWidget *         gtk_source_completion_provider_get_info_widget
                                                        (GtkSourceCompletionProvider *provider,
                                                         GtkSourceCompletionProposal *proposal);

Get a customized info widget to show extra information of a proposal. This allows for customized widgets on a proposal basis, although in general providers will have the same custom widget for all their proposals and proposal can be ignored. The implementation of this function is optional.

If this function is not implemented, the default widget is a GtkLabel. The return value of gtk_source_completion_proposal_get_info() is used as the content of the GtkLabel.

gtk_source_completion_provider_update_info ()

void                gtk_source_completion_provider_update_info
                                                        (GtkSourceCompletionProvider *provider,
                                                         GtkSourceCompletionProposal *proposal,
                                                         GtkSourceCompletionInfo *info);

Update extra information shown in info for proposal.

gtk_source_completion_provider_get_start_iter ()

gboolean            gtk_source_completion_provider_get_start_iter
                                                        (GtkSourceCompletionProvider *provider,
                                                         GtkSourceCompletionContext *context,
                                                         GtkSourceCompletionProposal *proposal,
                                                         GtkTextIter *iter);

Get the GtkTextIter at which the completion for proposal starts. When implemented, this information is used to position the completion window accordingly when a proposal is selected in the completion window. The proposal text inside the completion window is aligned on iter.

If this function is not implemented, the word boundary is taken to position the completion window. See gtk_source_completion_provider_activate_proposal() for an explanation on the word boundaries.

When the proposal is activated, the default handler uses iter as the start of the word to replace. See gtk_source_completion_provider_activate_proposal() for more information.

gtk_source_completion_provider_activate_proposal ()

gboolean            gtk_source_completion_provider_activate_proposal
                                                        (GtkSourceCompletionProvider *provider,
                                                         GtkSourceCompletionProposal *proposal,
                                                         GtkTextIter *iter);

Activate proposal at iter. When this functions returns FALSE, the default activation of proposal will take place which replaces the word at iter with the text of proposal (see gtk_source_completion_proposal_get_text()).

Here is how the default activation selects the boundaries of the word to replace. The end of the word is iter. For the start of the word, it depends on whether a start iter is defined for proposal (see gtk_source_completion_provider_get_start_iter()). If a start iter is defined, the start of the word is the start iter. Else, the word (as long as possible) will contain only alphanumerical and the "_" characters.

gtk_source_completion_provider_get_interactive_delay ()

gint                gtk_source_completion_provider_get_interactive_delay
                                                        (GtkSourceCompletionProvider *provider);

Get the delay in milliseconds before starting interactive completion for this provider. A value of -1 indicates to use the default value as set by the "auto-complete-delay" property.

gtk_source_completion_provider_get_priority ()

gint                gtk_source_completion_provider_get_priority
                                                        (GtkSourceCompletionProvider *provider);

Get the provider priority. The priority determines the order in which proposals appear in the completion popup. Higher priorities are sorted before lower priorities. The default priority is 0.