EvinceView.View¶

Subclasses:: None

Methods¶

Inherited:: Gtk.Container (35), Gtk.Widget (278), GObject.Object (37), Gtk.Buildable (10), Gtk.Scrollable (9)
Structs:: Gtk.ContainerClass (5), Gtk.WidgetClass (12), GObject.ObjectClass (5)

class	`new` ()
	`add_text_markup_annotation_for_selected_text` ()
	`autoscroll_start` ()
	`autoscroll_stop` ()
	`begin_add_annotation` (annot_type)
	`can_zoom_in` ()
	`can_zoom_out` ()
	`cancel_add_annotation` ()
	`copy` ()
	`copy_link_address` (action)
	`current_event_is_type` (type)
	`find_cancel` ()
	`find_next` ()
	`find_previous` ()
	`find_restart` (page)
	`find_search_changed` ()
	`find_set_highlight_search` (value)
	`find_set_result` (page, result)
	`find_started` (job)
	`focus_annotation` (annot_mapping)
	`get_allow_links_change_zoom` ()
	`get_enable_spellchecking` ()
	`get_has_selection` ()
	`get_page_extents` (page, page_area, border)
	`get_page_extents_for_border` (page, border, page_area)
	`get_selected_text` ()
	`handle_link` (link)
	`hide_cursor` ()
	`highlight_forward_search` (link)
	`is_caret_navigation_enabled` ()
	`is_loading` ()
	`next_page` ()
	`previous_page` ()
	`reload` ()
	`remove_annotation` (annot)
	`scroll` (scroll, horizontal)
	`select_all` ()
	`set_allow_links_change_zoom` (allowed)
	`set_caret_cursor_position` (page, offset)
	`set_caret_navigation_enabled` (enabled)
	`set_enable_spellchecking` (spellcheck)
	`set_loading` (loading)
	`set_model` (model)
	`set_page_cache_size` (cache_size)
	`show_cursor` ()
	`supports_caret_navigation` ()
	`zoom_in` ()
	`zoom_out` ()

Virtual Methods¶

Inherited:: Gtk.Container (10), Gtk.Widget (82), GObject.Object (7), Gtk.Buildable (10), Gtk.Scrollable (1)

Properties¶

Inherited:: Gtk.Container (3), Gtk.Widget (39), Gtk.Scrollable (4)

Name	Type	Flags	Short Description
`can-zoom-in`	`bool`	r	Whether the view can be zoomed in further
`can-zoom-out`	`bool`	r	Whether the view can be zoomed out further
`is-loading`	`bool`	r	Whether the view is loading

Style Properties¶

Inherited:: Gtk.Widget (17)

Signals¶

Inherited:: Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name	Short Description
`activate`
`annot-added`
`annot-cancel-add`
`annot-changed`
`annot-removed`
`cursor-moved`
`external-link`
`handle-link`
`layers-changed`
`move-cursor`
`popup`
`scroll`
`selection-changed`
`sync-source`

Fields¶

Inherited:: Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Class Details¶

class EvinceView.View(**kwargs)¶

Bases:: Gtk.Container, Gtk.Scrollable
Abstract:: No
Structure:: EvinceView.ViewClass

classmethod new()¶

Return type:: Gtk.Widget

add_text_markup_annotation_for_selected_text()¶

Returns:: True if annotations were added successfully, False otherwise.
Return type:: bool

Adds a Text Markup annotation (defaulting to a ‘highlight’ one) to the currently selected text on the document.

When the selected text spans more than one page, it will add a corresponding annotation for each page that contains selected text.

Added in version 3.30.

autoscroll_start()¶

autoscroll_stop()¶

begin_add_annotation(annot_type)¶

Parameters:: annot_type (EvinceDocument.AnnotationType)

can_zoom_in()¶

Return type:: bool

can_zoom_out()¶

Return type:: bool

cancel_add_annotation()¶

copy()¶

copy_link_address(action)¶

Parameters:: action (EvinceDocument.LinkAction)

current_event_is_type(type)¶

Parameters:: type (Gdk.EventType)
Return type:: bool

find_cancel()¶

find_next()¶

find_previous()¶

find_restart(page)¶

Parameters:: page (int) – a page index

Restart the current search operation from the given page.

Added in version 3.12.

find_search_changed()¶

find_set_highlight_search(value)¶

Parameters:: value (bool)

find_set_result(page, result)¶

Parameters:

page (int)
result (int)

FIXME

Added in version 3.10.

find_started(job)¶

Parameters:: job (EvinceView.JobFind)

Added in version 3.6.

focus_annotation(annot_mapping)¶

Parameters:: annot_mapping (EvinceDocument.Mapping)

get_allow_links_change_zoom()¶

Return type:: bool

get_enable_spellchecking()¶

Return type:: bool

get_has_selection()¶

Return type:: bool

get_page_extents(page, page_area, border)¶

Parameters:

page (int)
page_area (Gdk.Rectangle)
border (Gtk.Border)

Return type:

bool

get_page_extents_for_border(page, border, page_area)¶

Parameters:

page (int)
border (Gtk.Border)
page_area (Gdk.Rectangle)

Return type:

bool

get_selected_text()¶

Returns:: The string representing selected text.
Return type:: str

Returns a pointer to a constant string containing the selected text in the view.

The value returned may be None if there is no selected text.

Added in version 3.30.

handle_link(link)¶

Parameters:: link (EvinceDocument.Link)

hide_cursor()¶

highlight_forward_search(link)¶

Parameters:: link (EvinceDocument.SourceLink)

is_caret_navigation_enabled()¶

Return type:: bool

is_loading()¶

Returns:: True iff the view is currently loading a document
Return type:: bool

Added in version 3.8.

next_page()¶

Return type:: bool

previous_page()¶

Return type:: bool

reload()¶

remove_annotation(annot)¶

Parameters:: annot (EvinceDocument.Annotation)

scroll(scroll, horizontal)¶

Parameters:

scroll (Gtk.ScrollType)
horizontal (bool)

Deprecated since version 3.10.

select_all()¶

set_allow_links_change_zoom(allowed)¶

Parameters:: allowed (bool)

set_caret_cursor_position(page, offset)¶

Parameters:

page (int)
offset (int)

Added in version 3.10.

set_caret_navigation_enabled(enabled)¶

Parameters:: enabled (bool) – whether to enable caret navigation mode

Enables or disables caret navigation mode for the document.

Added in version 3.10.

set_enable_spellchecking(spellcheck)¶

Parameters:: spellcheck (bool)

set_loading(loading)¶

Parameters:: loading (bool)

Deprecated since version 3.8.

set_model(model)¶

Parameters:: model (EvinceView.DocumentModel)

set_page_cache_size(cache_size)¶

Parameters:: cache_size (int) – size in bytes

Sets the maximum size in bytes that will be used to cache rendered pages. Use 0 to disable caching rendered pages.

Note that this limit doesn’t affect the current visible page range, which will always be rendered. In order to limit the total memory used you have to use EvinceView.DocumentModel.set_max_scale() too.

show_cursor()¶

supports_caret_navigation()¶

Returns:: whether the document supports caret navigation
Return type:: bool

Added in version 3.10.

zoom_in()¶

zoom_out()¶

Signal Details¶

EvinceView.View.signals.activate(view)¶

Signal Name:: activate
Flags:: RUN_FIRST, ACTION
Parameters:: view (EvinceView.View) – The object which received the signal

EvinceView.View.signals.annot_added(view, object)¶

Signal Name:

annot-added

Flags:

RUN_LAST, ACTION

Parameters:

view (EvinceView.View) – The object which received the signal
object (EvinceDocument.Annotation)

EvinceView.View.signals.annot_cancel_add(view)¶

Signal Name:: annot-cancel-add
Flags:: RUN_LAST, ACTION
Parameters:: view (EvinceView.View) – The object which received the signal

EvinceView.View.signals.annot_changed(view, object)¶

Signal Name:

annot-changed

Flags:

RUN_LAST, ACTION

Parameters:

view (EvinceView.View) – The object which received the signal
object (EvinceDocument.Annotation)

EvinceView.View.signals.annot_removed(view, object)¶

Signal Name:

annot-removed

Flags:

RUN_LAST, ACTION

Parameters:

view (EvinceView.View) – The object which received the signal
object (EvinceDocument.Annotation)

EvinceView.View.signals.cursor_moved(view, object, p0)¶

Signal Name:

cursor-moved

Flags:

RUN_LAST

Parameters:

view (EvinceView.View) – The object which received the signal
object (int)
p0 (int)

EvinceView.View.signals.external_link(view, object)¶

Signal Name:

external-link

Flags:

RUN_LAST, ACTION

Parameters:

view (EvinceView.View) – The object which received the signal
object (GObject.Object)

EvinceView.View.signals.handle_link(view, object, p0)¶

Signal Name:

handle-link

Flags:

RUN_LAST, ACTION

Parameters:

view (EvinceView.View) – The object which received the signal
object (int)
p0 (GObject.Object)

EvinceView.View.signals.layers_changed(view)¶

Signal Name:: layers-changed
Flags:: RUN_LAST, ACTION
Parameters:: view (EvinceView.View) – The object which received the signal

EvinceView.View.signals.move_cursor(view, object, p0, p1)¶

Signal Name:

move-cursor

Flags:

RUN_LAST, ACTION

Parameters:

view (EvinceView.View) – The object which received the signal
object (Gtk.MovementStep)
p0 (int)
p1 (bool)

Return type:

bool

EvinceView.View.signals.popup(view, object)¶

Signal Name:

popup

Flags:

RUN_LAST, ACTION

Parameters:

view (EvinceView.View) – The object which received the signal
object (object or None)

EvinceView.View.signals.scroll(view, object, p0)¶

Signal Name:

scroll

Flags:

RUN_LAST, ACTION

Parameters:

view (EvinceView.View) – The object which received the signal
object (Gtk.ScrollType)
p0 (Gtk.Orientation)

EvinceView.View.signals.selection_changed(view)¶

Signal Name:: selection-changed
Flags:: RUN_LAST, ACTION
Parameters:: view (EvinceView.View) – The object which received the signal

EvinceView.View.signals.sync_source(view, object)¶

Signal Name:

sync-source

Flags:

RUN_LAST, ACTION

Parameters:

view (EvinceView.View) – The object which received the signal
object (EvinceDocument.SourceLink)

Property Details¶

EvinceView.View.props.can_zoom_in¶

Name:: can-zoom-in
Type:: bool
Default Value:: True
Flags:: READABLE

Whether the view can be zoomed in further

Added in version 3.8.

EvinceView.View.props.can_zoom_out¶

Name:: can-zoom-out
Type:: bool
Default Value:: True
Flags:: READABLE

Whether the view can be zoomed out further

Added in version 3.8.

EvinceView.View.props.is_loading¶

Name:: is-loading
Type:: bool
Default Value:: False
Flags:: READABLE

Allows to implement a custom notification system.

Added in version 3.8.