gtksourceviewmm  2.10.3
Public Member Functions | Related Functions
gtksourceview::SourceCompletion Class Reference

Main Completion Object. More...

#include <gtksourceviewmm/sourcecompletion.h>

Inheritance diagram for gtksourceview::SourceCompletion:
Inheritance graph
[legend]

List of all members.

Public Member Functions

GtkSourceCompletion* gobj ()
 Provides access to the underlying C GtkObject.
const GtkSourceCompletion* gobj () const
 Provides access to the underlying C GtkObject.
bool add_provider (const Glib::RefPtr< SourceCompletionProvider >& provider)
 Add a new SourceCompletionProvider to the completion object.
bool remove_provider (const Glib::RefPtr< SourceCompletionProvider >& provider)
 Remove provider from the completion.
Glib::ListHandle< Glib::RefPtr
< SourceCompletionProvider > > 
get_providers () const
 Get list of providers registered on completion.
bool show (const Glib::ListHandle< Glib::RefPtr< SourceCompletionProvider > >& providers, const Glib::RefPtr< SourceCompletionContext >& context)
 Starts a new completion with the specified SourceCompletionContext and a list of potential candidate providers for completion.
void hide ()
 Hides the completion if it is active (visible).
SourceCompletionInfoget_info_window ()
 Gets the SourceCompletionInfo window.
const SourceCompletionInfoget_info_window () const
 Gets the SourceCompletionInfo window.
SourceViewget_view ()
 Gets the SourceView associated with completion.
const SourceViewget_view () const
 Gets the SourceView associated with completion.
Glib::RefPtr
< SourceCompletionContext
create_context (const Gtk::TextIter& position)
 Create a new SourceCompletionContext for completion.
Glib::RefPtr
< SourceCompletionContext
create_context ()
 Create a new SourceCompletionContext for completion.
void move_window (const Gtk::TextIter& iter)
 Move the completion window to a specific iter.
void block_interactive ()
 Block interactive completion.
void unblock_interactive ()
 Unblock interactive completion.
Glib::SignalProxy0< void > signal_hide ()
 Emitted when the completion window is hidden.
Glib::SignalProxy1< void,
const Glib::RefPtr
< SourceCompletionContext >& > 
signal_populate_context ()
 Emitted just before starting to populate the completion with providers.
Glib::SignalProxy0< void > signal_show ()
 Emitted when the completion window is shown.
Glib::PropertyProxy< guint > property_accelerators ()
 Number of proposal accelerators to show.
Glib::PropertyProxy_ReadOnly
< guint > 
property_accelerators () const
 Number of proposal accelerators to show.
Glib::PropertyProxy< guint > property_auto_complete_delay ()
 Completion popup delay for interactive completion.
Glib::PropertyProxy_ReadOnly
< guint > 
property_auto_complete_delay () const
 Completion popup delay for interactive completion.
Glib::PropertyProxy< guint > property_proposal_page_size ()
 Proposal scrolling page size.
Glib::PropertyProxy_ReadOnly
< guint > 
property_proposal_page_size () const
 Proposal scrolling page size.
Glib::PropertyProxy< guint > property_provider_page_size ()
 Provider scrolling page size.
Glib::PropertyProxy_ReadOnly
< guint > 
property_provider_page_size () const
 Provider scrolling page size.
Glib::PropertyProxy< bool > property_remember_info_visibility ()
 Remember the last info window visibility state.
Glib::PropertyProxy_ReadOnly
< bool > 
property_remember_info_visibility () const
 Remember the last info window visibility state.
Glib::PropertyProxy< bool > property_select_on_show ()
 Select first proposal when completion is shown.
Glib::PropertyProxy_ReadOnly
< bool > 
property_select_on_show () const
 Select first proposal when completion is shown.
Glib::PropertyProxy< bool > property_show_headers ()
 Show provider headers when proposals from multiple providers are available.
Glib::PropertyProxy_ReadOnly
< bool > 
property_show_headers () const
 Show provider headers when proposals from multiple providers are available.
Glib::PropertyProxy< bool > property_show_icons ()
 Show provider and proposal icons in the completion popup.
Glib::PropertyProxy_ReadOnly
< bool > 
property_show_icons () const
 Show provider and proposal icons in the completion popup.
Glib::PropertyProxy_ReadOnly
< SourceView* > 
property_view () const
 The GtkSourceView bound to the completion.

Related Functions

(Note that these are not member functions.)

gtksourceview::SourceCompletionwrap (GtkSourceCompletion* object, bool take_copy=false)
 A Glib::wrap() method for this object.

Detailed Description

Main Completion Object.

Since gtksourceviewmm 2.10:

Member Function Documentation

bool gtksourceview::SourceCompletion::add_provider ( const Glib::RefPtr< SourceCompletionProvider >&  provider)

Add a new SourceCompletionProvider to the completion object.

This will add a reference provider.

Parameters:
providerA SourceCompletionProvider.
Returns:
true if provider was successfully added, otherwise error is thrown.
Since gtksourceviewmm 2.10:
void gtksourceview::SourceCompletion::block_interactive ( )

Block interactive completion.

This can be used to disable interactive completion when inserting or deleting text from the buffer associated with the completion. Use unblock_interactive() to enable interactive completion again.

Since gtksourceviewmm 2.10:
Glib::RefPtr<SourceCompletionContext> gtksourceview::SourceCompletion::create_context ( const Gtk::TextIter position)

Create a new SourceCompletionContext for completion.

The position at which the completion using the new context will consider completion can be provided by position.

Parameters:
positionA Gtk::TextIter.
Returns:
A new SourceCompletionContext.
Since gtksourceviewmm 2.10:
Glib::RefPtr<SourceCompletionContext> gtksourceview::SourceCompletion::create_context ( )

Create a new SourceCompletionContext for completion.

The position at which the completion using the new context will consider completion is current cursor position.

Returns:
A new SourceCompletionContext.
Since gtksourceviewmm 2.10:
SourceCompletionInfo* gtksourceview::SourceCompletion::get_info_window ( )

Gets the SourceCompletionInfo window.

The info widget is the window where the completion displays optional extra information of the proposal.

Returns:
The SourceCompletionInfo window.
Since gtksourceviewmm 2.10:
const SourceCompletionInfo* gtksourceview::SourceCompletion::get_info_window ( ) const

Gets the SourceCompletionInfo window.

The info widget is the window where the completion displays optional extra information of the proposal.

Returns:
The SourceCompletionInfo window.
Since gtksourceviewmm 2.10:
Glib::ListHandle<Glib::RefPtr<SourceCompletionProvider> > gtksourceview::SourceCompletion::get_providers ( ) const

Get list of providers registered on completion.

Returns:
List of SourceCompletionProvider.
Since gtksourceviewmm 2.10:
SourceView* gtksourceview::SourceCompletion::get_view ( )

Gets the SourceView associated with completion.

Returns:
The SourceView associated with completion.
Since gtksourceviewmm 2.10:
const SourceView* gtksourceview::SourceCompletion::get_view ( ) const

Gets the SourceView associated with completion.

Returns:
The SourceView associated with completion.
Since gtksourceviewmm 2.10:
void gtksourceview::SourceCompletion::hide ( )

Hides the completion if it is active (visible).

Since gtksourceviewmm 2.10:
void gtksourceview::SourceCompletion::move_window ( const Gtk::TextIter iter)

Move the completion window to a specific iter.

Parameters:
iterA Gtk::TextIter.
Since gtksourceviewmm 2.10:
Glib::PropertyProxy<guint> gtksourceview::SourceCompletion::property_accelerators ( )

Number of proposal accelerators to show.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly<guint> gtksourceview::SourceCompletion::property_accelerators ( ) const

Number of proposal accelerators to show.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy<guint> gtksourceview::SourceCompletion::property_auto_complete_delay ( )

Completion popup delay for interactive completion.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly<guint> gtksourceview::SourceCompletion::property_auto_complete_delay ( ) const

Completion popup delay for interactive completion.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy<guint> gtksourceview::SourceCompletion::property_proposal_page_size ( )

Proposal scrolling page size.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly<guint> gtksourceview::SourceCompletion::property_proposal_page_size ( ) const

Proposal scrolling page size.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy<guint> gtksourceview::SourceCompletion::property_provider_page_size ( )

Provider scrolling page size.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly<guint> gtksourceview::SourceCompletion::property_provider_page_size ( ) const

Provider scrolling page size.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy<bool> gtksourceview::SourceCompletion::property_remember_info_visibility ( )

Remember the last info window visibility state.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly<bool> gtksourceview::SourceCompletion::property_remember_info_visibility ( ) const

Remember the last info window visibility state.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy<bool> gtksourceview::SourceCompletion::property_select_on_show ( )

Select first proposal when completion is shown.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly<bool> gtksourceview::SourceCompletion::property_select_on_show ( ) const

Select first proposal when completion is shown.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy<bool> gtksourceview::SourceCompletion::property_show_headers ( )

Show provider headers when proposals from multiple providers are available.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly<bool> gtksourceview::SourceCompletion::property_show_headers ( ) const

Show provider headers when proposals from multiple providers are available.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy<bool> gtksourceview::SourceCompletion::property_show_icons ( )

Show provider and proposal icons in the completion popup.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly<bool> gtksourceview::SourceCompletion::property_show_icons ( ) const

Show provider and proposal icons in the completion popup.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly<SourceView*> gtksourceview::SourceCompletion::property_view ( ) const

The GtkSourceView bound to the completion.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
bool gtksourceview::SourceCompletion::remove_provider ( const Glib::RefPtr< SourceCompletionProvider >&  provider)

Remove provider from the completion.

Parameters:
providerA SourceCompletionProvider.
Returns:
true if provider was successfully removed, otherwise error is thrown.
Since gtksourceviewmm 2.10:
bool gtksourceview::SourceCompletion::show ( const Glib::ListHandle< Glib::RefPtr< SourceCompletionProvider > >&  providers,
const Glib::RefPtr< SourceCompletionContext >&  context 
)

Starts a new completion with the specified SourceCompletionContext and a list of potential candidate providers for completion.

Parameters:
providersA list of SourceCompletionProvider.
contextThe SourceCompletionContext with which to start the completion.
Returns:
true if it was possible to the show completion window.
Since gtksourceviewmm 2.10:
Glib::SignalProxy0< void > gtksourceview::SourceCompletion::signal_hide ( )

Emitted when the completion window is hidden.

The default handler will actually hide the window.

Since gtksourceviewmm 2.10:
Prototype:
void on_my_hide()
Glib::SignalProxy1< void,const Glib::RefPtr<SourceCompletionContext>& > gtksourceview::SourceCompletion::signal_populate_context ( )

Emitted just before starting to populate the completion with providers.

You can use this signal to add additional attributes in the context.

Handler parameters:
context The context for current completion.
Since gtksourceviewmm 2.10:
Prototype:
void on_my_populate_context(const Glib::RefPtr<SourceCompletionContext>& context)
Glib::SignalProxy0< void > gtksourceview::SourceCompletion::signal_show ( )

Emitted when the completion window is shown.

The default handler will actually show the window.

Since gtksourceviewmm 2.10:
Prototype:
void on_my_show()
void gtksourceview::SourceCompletion::unblock_interactive ( )

Unblock interactive completion.

This can be used after using block_interactive() to enable interactive completion again.

Since gtksourceviewmm 2.10:

Friends And Related Function Documentation

gtksourceview::SourceCompletion* wrap ( GtkSourceCompletion *  object,
bool  take_copy = false 
) [related]

A Glib::wrap() method for this object.

Parameters:
objectThe C instance.
take_copyFalse 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.