ev-view-accessible.c File Reference

#include <math.h>
#include <config.h>
#include <glib/gi18n-lib.h>
#include <gtk/gtk.h>
#include "ev-selection.h"
#include "ev-page-cache.h"
#include "ev-view-accessible.h"
#include "ev-view-private.h"
#include "ev-page-accessible.h"

Include dependency graph for ev-view-accessible.c:

Go to the source code of this file.

Data Structures
struct	_EvViewAccessiblePrivate

Enumerations
enum	{ ACTION_SCROLL_UP, ACTION_SCROLL_DOWN, LAST_ACTION }

Functions
static void	ev_view_accessible_action_iface_init (AtkActionIface *iface)
static void	ev_view_accessible_document_iface_init (AtkDocumentIface *iface)
	G_DEFINE_TYPE_WITH_CODE (EvViewAccessible, ev_view_accessible, GTK_TYPE_CONTAINER_ACCESSIBLE)
static void	clear_children (EvViewAccessible *self)
static void	ev_view_accessible_finalize (GObject *object)
static void	ev_view_accessible_initialize (AtkObject *obj, gpointer data)
gint	ev_view_accessible_get_n_pages (EvViewAccessible *self)
static AtkObject *	ev_view_accessible_ref_child (AtkObject *obj, gint i)
static gint	ev_view_accessible_get_n_children (AtkObject *obj)
static void	ev_view_accessible_class_init (EvViewAccessibleClass *klass)
static void	ev_view_accessible_init (EvViewAccessible *accessible)
static gboolean	ev_view_accessible_idle_do_action (gpointer data)
static gboolean	ev_view_accessible_action_do_action (AtkAction *action, gint i)
static gint	ev_view_accessible_action_get_n_actions (AtkAction *action)
static const gchar *	ev_view_accessible_action_get_description (AtkAction *action, gint i)
static const gchar *	ev_view_accessible_action_get_name (AtkAction *action, gint i)
static gboolean	ev_view_accessible_action_set_description (AtkAction *action, gint i, const gchar *description)
static void	ev_view_accessible_cursor_moved (EvView *view, gint page, gint offset, EvViewAccessible *accessible)
static void	ev_view_accessible_selection_changed (EvView *view, EvViewAccessible *view_accessible)
static void	page_changed_cb (EvDocumentModel *model, gint old_page, gint new_page, EvViewAccessible *accessible)
static void	initialize_children (EvViewAccessible *self)
static void	document_changed_cb (EvDocumentModel *model, GParamSpec *pspec, EvViewAccessible *accessible)
void	ev_view_accessible_set_model (EvViewAccessible *accessible, EvDocumentModel *model)
static gboolean	ev_view_accessible_focus_changed (GtkWidget *widget, GdkEventFocus *event, EvViewAccessible *self)
AtkObject *	ev_view_accessible_new (GtkWidget *widget)
gint	ev_view_accessible_get_relevant_page (EvViewAccessible *accessible)
void	_transform_doc_rect_to_atk_rect (EvViewAccessible *accessible, gint page, EvRectangle *doc_rect, EvRectangle *atk_rect, AtkCoordType coord_type)
gboolean	ev_view_accessible_is_doc_rect_showing (EvViewAccessible *accessible, gint page, EvRectangle *doc_rect)
void	ev_view_accessible_set_page_range (EvViewAccessible *accessible, gint start, gint end)
void	ev_view_accessible_set_focused_element (EvViewAccessible *accessible, EvMapping *new_focus, gint new_focus_page)
void	ev_view_accessible_update_element_state (EvViewAccessible *accessible, EvMapping *element, gint element_page)

Variables
static const gchar *const	ev_view_accessible_action_names []
static const gchar *const	ev_view_accessible_action_descriptions []

Enumeration Type Documentation

anonymous enum

Enumerator
ACTION_SCROLL_UP
ACTION_SCROLL_DOWN
LAST_ACTION

Definition at line 35 of file ev-view-accessible.c.

     {
    ACTION_SCROLL_UP,
    ACTION_SCROLL_DOWN,
    LAST_ACTION
};

Function Documentation

void _transform_doc_rect_to_atk_rect	(	EvViewAccessible *	accessible,
		gint	page,
		EvRectangle *	doc_rect,
		EvRectangle *	atk_rect,
		AtkCoordType	coord_type
	)

Definition at line 517 of file ev-view-accessible.c.

{
    EvView *view;
    GdkRectangle view_rect;
    GtkWidget *widget, *toplevel;
    gint x_widget, y_widget;

    view = EV_VIEW (gtk_accessible_get_widget (GTK_ACCESSIBLE (accessible)));
    _ev_view_transform_doc_rect_to_view_rect (view, page, doc_rect, &view_rect);
    view_rect.x -= view->scroll_x;
    view_rect.y -= view->scroll_y;

    widget = GTK_WIDGET (view);
    toplevel = gtk_widget_get_toplevel (widget);
    gtk_widget_translate_coordinates (widget, toplevel, 0, 0, &x_widget, &y_widget);
    view_rect.x += x_widget;
    view_rect.y += y_widget;

    if (coord_type == ATK_XY_SCREEN) {
        gint x_window, y_window;
        gdk_window_get_origin (gtk_widget_get_window (toplevel), &x_window, &y_window);
        view_rect.x += x_window;
        view_rect.y += y_window;
    }

    atk_rect->x1 = view_rect.x;
    atk_rect->y1 = view_rect.y;
    atk_rect->x2 = view_rect.x + view_rect.width;
    atk_rect->y2 = view_rect.y + view_rect.height;
}

Here is the caller graph for this function:

static void clear_children ( EvViewAccessible *  self)

static

Definition at line 83 of file ev-view-accessible.c.

{
    gint i;
    AtkObject *child;

    if (self->priv->children == NULL)
        return;

    for (i = 0; i < self->priv->children->len; i++) {
        child = g_ptr_array_index (self->priv->children, i);
        atk_object_notify_state_change (child, ATK_STATE_DEFUNCT, TRUE);
    }

    g_clear_pointer (&self->priv->children, g_ptr_array_unref);
}

Here is the caller graph for this function:

static void document_changed_cb ( EvDocumentModel *  model, GParamSpec *  pspec, EvViewAccessible *  accessible  )

static

Definition at line 403 of file ev-view-accessible.c.

{
    EvDocument *document = ev_document_model_get_document (model);

    clear_children (accessible);

    if (document == NULL)
        return;

    initialize_children (accessible);

    /* Inside this callback the document is already loaded. We
     * don't have here an "just before" and "just after"
     * signal. We emit both in a row, as usual ATs uses reload to
     * know that current content has changed, and load-complete to
     * know that the content is already available.
     */
    g_signal_emit_by_name (accessible, "reload");
    g_signal_emit_by_name (accessible, "load-complete");
}

Here is the caller graph for this function:

static gboolean ev_view_accessible_action_do_action ( AtkAction *  action, gint  i  )

static

Definition at line 235 of file ev-view-accessible.c.

{
    EvViewAccessiblePrivate* priv = EV_VIEW_ACCESSIBLE (action)->priv;

    if (gtk_accessible_get_widget (GTK_ACCESSIBLE (action)) == NULL)
        return FALSE;

    if (priv->action_idle_handler)
        return FALSE;

    switch (i) {
    case ACTION_SCROLL_UP:
        priv->idle_scroll = GTK_SCROLL_PAGE_BACKWARD;
        break;
    case ACTION_SCROLL_DOWN:
        priv->idle_scroll = GTK_SCROLL_PAGE_FORWARD;
        break;
    default:
        return FALSE;
    }
    priv->action_idle_handler = g_idle_add (ev_view_accessible_idle_do_action,
                                            action);
    return TRUE;
}

Here is the caller graph for this function:

static const gchar* ev_view_accessible_action_get_description ( AtkAction *  action, gint  i  )

static

Definition at line 268 of file ev-view-accessible.c.

{
    EvViewAccessiblePrivate* priv = EV_VIEW_ACCESSIBLE (action)->priv;

    if (i < 0 || i >= LAST_ACTION)
        return NULL;

    if (priv->action_descriptions[i])
        return priv->action_descriptions[i];
    else
        return ev_view_accessible_action_descriptions[i];
}

Here is the caller graph for this function:

static gint ev_view_accessible_action_get_n_actions ( AtkAction *  action)

static

Definition at line 262 of file ev-view-accessible.c.

{
    return LAST_ACTION;
}

Here is the caller graph for this function:

static const gchar* ev_view_accessible_action_get_name ( AtkAction *  action, gint  i  )

static

Definition at line 283 of file ev-view-accessible.c.

{
    if (i < 0 || i >= LAST_ACTION)
        return NULL;

    return ev_view_accessible_action_names[i];
}

Here is the caller graph for this function:

static void ev_view_accessible_action_iface_init ( AtkActionIface *  iface)

static

Definition at line 311 of file ev-view-accessible.c.

{
    iface->do_action = ev_view_accessible_action_do_action;
    iface->get_n_actions = ev_view_accessible_action_get_n_actions;
    iface->get_description = ev_view_accessible_action_get_description;
    iface->get_name = ev_view_accessible_action_get_name;
    iface->set_description = ev_view_accessible_action_set_description;
}

static gboolean ev_view_accessible_action_set_description ( AtkAction *  action, gint  i, const gchar *  description  )

static

Definition at line 293 of file ev-view-accessible.c.

{
    EvViewAccessiblePrivate* priv = EV_VIEW_ACCESSIBLE (action)->priv;
    gchar *old_description;

    if (i < 0 || i >= LAST_ACTION)
        return FALSE;

    old_description = priv->action_descriptions[i];
    priv->action_descriptions[i] = g_strdup (description);
    g_free (old_description);

    return TRUE;
}

Here is the caller graph for this function:

static void ev_view_accessible_class_init ( EvViewAccessibleClass *  klass)

static

Definition at line 169 of file ev-view-accessible.c.

{
    GObjectClass *object_class = G_OBJECT_CLASS (klass);
    AtkObjectClass *atk_class = ATK_OBJECT_CLASS (klass);

    object_class->finalize = ev_view_accessible_finalize;
    atk_class->initialize = ev_view_accessible_initialize;
    atk_class->get_n_children = ev_view_accessible_get_n_children;
    atk_class->ref_child = ev_view_accessible_ref_child;

    g_type_class_add_private (klass, sizeof (EvViewAccessiblePrivate));
}

static void ev_view_accessible_cursor_moved ( EvView *  view, gint  page, gint  offset, EvViewAccessible *  accessible  )

static

Definition at line 321 of file ev-view-accessible.c.

{
    EvViewAccessiblePrivate* priv = accessible->priv;
    EvPageAccessible *page_accessible = NULL;

    if (priv->previous_cursor_page != page) {
        AtkObject *previous_page = NULL;
        AtkObject *current_page = NULL;

        previous_page = g_ptr_array_index (priv->children,
                           priv->previous_cursor_page);
        atk_object_notify_state_change (previous_page, ATK_STATE_FOCUSED, FALSE);
        priv->previous_cursor_page = page;
        current_page = g_ptr_array_index (priv->children, page);
        atk_object_notify_state_change (current_page, ATK_STATE_FOCUSED, TRUE);

#if ATK_CHECK_VERSION (2, 11, 2)
        /* +1 as user start to count on 1, but evince starts on 0 */
        g_signal_emit_by_name (accessible, "page-changed", page + 1);
#endif
    }

    page_accessible = g_ptr_array_index (priv->children, page);
    g_signal_emit_by_name (page_accessible, "text-caret-moved", offset);
}

Here is the caller graph for this function:

static void ev_view_accessible_document_iface_init ( AtkDocumentIface *  iface)

static

Definition at line 214 of file ev-view-accessible.c.

{
#if ATK_CHECK_VERSION (2, 11, 3)
    iface->get_current_page_number = ev_view_accessible_get_current_page_number;
    iface->get_page_count = ev_view_accessible_get_page_count;
#endif
}

static void ev_view_accessible_finalize ( GObject *  object)

static

Definition at line 100 of file ev-view-accessible.c.

{
    EvViewAccessiblePrivate *priv = EV_VIEW_ACCESSIBLE (object)->priv;
    int i;

    if (priv->model) {
        g_signal_handlers_disconnect_by_data (priv->model, object);
        g_object_unref (priv->model);
        priv->model = NULL;
    }
    if (priv->action_idle_handler)
        g_source_remove (priv->action_idle_handler);
    for (i = 0; i < LAST_ACTION; i++)
        g_free (priv->action_descriptions [i]);

    clear_children (EV_VIEW_ACCESSIBLE (object));

    G_OBJECT_CLASS (ev_view_accessible_parent_class)->finalize (object);
}

Here is the caller graph for this function:

static gboolean ev_view_accessible_focus_changed ( GtkWidget *  widget, GdkEventFocus *  event, EvViewAccessible *  self  )

static

Definition at line 452 of file ev-view-accessible.c.

{
    AtkObject *page_accessible;

    g_return_val_if_fail (EV_IS_VIEW (widget), FALSE);
    g_return_val_if_fail (EV_IS_VIEW_ACCESSIBLE (self), FALSE);

    if (self->priv->children == NULL || self->priv->children->len == 0)
        return FALSE;

    page_accessible = g_ptr_array_index (self->priv->children,
                         get_relevant_page (EV_VIEW (widget)));
    atk_object_notify_state_change (page_accessible,
                    ATK_STATE_FOCUSED, event->in);

    return FALSE;
}

Here is the caller graph for this function:

static gint ev_view_accessible_get_n_children ( AtkObject *  obj)

static

Definition at line 163 of file ev-view-accessible.c.

{
    return ev_view_accessible_get_n_pages (EV_VIEW_ACCESSIBLE (obj));
}

Here is the caller graph for this function:

gint ev_view_accessible_get_n_pages

(

EvViewAccessible *

self)

Definition at line 134 of file ev-view-accessible.c.

{
    return self->priv->children == NULL ? 0 : self->priv->children->len;
}

Here is the caller graph for this function:

gint ev_view_accessible_get_relevant_page

(

EvViewAccessible *

accessible)

Definition at line 505 of file ev-view-accessible.c.

{
    EvView *view;

    g_return_val_if_fail (EV_IS_VIEW_ACCESSIBLE (accessible), -1);

    view = EV_VIEW (gtk_accessible_get_widget (GTK_ACCESSIBLE (accessible)));

    return get_relevant_page (view);
}

Here is the caller graph for this function:

static gboolean ev_view_accessible_idle_do_action ( gpointer  data)

static

Definition at line 223 of file ev-view-accessible.c.

{
    EvViewAccessiblePrivate* priv = EV_VIEW_ACCESSIBLE (data)->priv;

    ev_view_scroll (EV_VIEW (gtk_accessible_get_widget (GTK_ACCESSIBLE (data))),
                    priv->idle_scroll,
                    FALSE);
    priv->action_idle_handler = 0;
    return FALSE;
}

Here is the caller graph for this function:

static void ev_view_accessible_init ( EvViewAccessible *  accessible)

static

Definition at line 183 of file ev-view-accessible.c.

{
    accessible->priv = G_TYPE_INSTANCE_GET_PRIVATE (accessible, EV_TYPE_VIEW_ACCESSIBLE, EvViewAccessiblePrivate);
}

static void ev_view_accessible_initialize ( AtkObject *  obj, gpointer  data  )

static

Definition at line 121 of file ev-view-accessible.c.

{
    if (ATK_OBJECT_CLASS (ev_view_accessible_parent_class)->initialize != NULL)
        ATK_OBJECT_CLASS (ev_view_accessible_parent_class)->initialize (obj, data);

    gtk_accessible_set_widget (GTK_ACCESSIBLE (obj), GTK_WIDGET (data));

    atk_object_set_name (obj, _("Document View"));
    atk_object_set_role (obj, ATK_ROLE_DOCUMENT_FRAME);
}

Here is the caller graph for this function:

gboolean ev_view_accessible_is_doc_rect_showing	(	EvViewAccessible *	accessible,
		gint	page,
		EvRectangle *	doc_rect
	)

Definition at line 553 of file ev-view-accessible.c.

{
    EvView *view;
    GdkRectangle view_rect;
    GtkAllocation allocation;
    gint x, y;
    gboolean hidden;

    view = EV_VIEW (gtk_accessible_get_widget (GTK_ACCESSIBLE (accessible)));
    if (page < view->start_page || page > view->end_page)
        return FALSE;

    gtk_widget_get_allocation (GTK_WIDGET (view), &allocation);
    x = gtk_adjustment_get_value (view->hadjustment);
    y = gtk_adjustment_get_value (view->vadjustment);

    _ev_view_transform_doc_rect_to_view_rect (view, page, doc_rect, &view_rect);
    hidden = view_rect.x + view_rect.width < x || view_rect.x > x + allocation.width ||
        view_rect.y + view_rect.height < y || view_rect.y > y + allocation.height;

    return !hidden;
}

Here is the caller graph for this function:

AtkObject* ev_view_accessible_new

(

GtkWidget *

widget)

Definition at line 473 of file ev-view-accessible.c.

{
    AtkObject *accessible;
    EvView    *view;

    g_return_val_if_fail (EV_IS_VIEW (widget), NULL);

    accessible = g_object_new (EV_TYPE_VIEW_ACCESSIBLE, NULL);
    atk_object_initialize (accessible, widget);

    g_signal_connect (widget, "cursor-moved",
              G_CALLBACK (ev_view_accessible_cursor_moved),
              accessible);
    g_signal_connect (widget, "selection-changed",
              G_CALLBACK (ev_view_accessible_selection_changed),
              accessible);
    g_signal_connect (widget, "focus-in-event",
              G_CALLBACK (ev_view_accessible_focus_changed),
              accessible);
    g_signal_connect (widget, "focus-out-event",
              G_CALLBACK (ev_view_accessible_focus_changed),
              accessible);

    view = EV_VIEW (widget);
    if (view->model)
        ev_view_accessible_set_model (EV_VIEW_ACCESSIBLE (accessible),
                          view->model);

    return accessible;
}

Here is the caller graph for this function:

static AtkObject* ev_view_accessible_ref_child ( AtkObject *  obj, gint  i  )

static

Definition at line 140 of file ev-view-accessible.c.

{
    EvViewAccessible *self;
    EvView *view;

    g_return_val_if_fail (EV_IS_VIEW_ACCESSIBLE (obj), NULL);
    self = EV_VIEW_ACCESSIBLE (obj);
    g_return_val_if_fail (i >= 0 || i < ev_view_accessible_get_n_pages (self), NULL);

    view = EV_VIEW (gtk_accessible_get_widget (GTK_ACCESSIBLE (obj)));
    if (view == NULL)
        return NULL;

    /* If a given page is requested, we assume that the text would
     * be requested soon, so we need to be sure that is cached.*/
    if (view->page_cache)
        ev_page_cache_ensure_page (view->page_cache, i);

    return g_object_ref (g_ptr_array_index (self->priv->children, i));
}

Here is the caller graph for this function:

static void ev_view_accessible_selection_changed ( EvView *  view, EvViewAccessible *  view_accessible  )

static

Definition at line 351 of file ev-view-accessible.c.

{
    AtkObject *page_accessible;

    page_accessible = g_ptr_array_index (view_accessible->priv->children,
                         get_relevant_page (view));
    g_signal_emit_by_name (page_accessible, "text-selection-changed");
}

Here is the caller graph for this function:

void ev_view_accessible_set_focused_element	(	EvViewAccessible *	accessible,
		EvMapping *	new_focus,
		gint	new_focus_page
	)

Definition at line 607 of file ev-view-accessible.c.

{
    EvPageAccessible *page;

    if (accessible->priv->focused_element) {
        atk_object_notify_state_change (accessible->priv->focused_element, ATK_STATE_FOCUSED, FALSE);
        accessible->priv->focused_element = NULL;
    }

    if (!new_focus || new_focus_page == -1)
        return;

    page = g_ptr_array_index (accessible->priv->children, new_focus_page);
    accessible->priv->focused_element = ev_page_accessible_get_accessible_for_mapping (page, new_focus);
    if (accessible->priv->focused_element)
        atk_object_notify_state_change (accessible->priv->focused_element, ATK_STATE_FOCUSED, TRUE);
}

Here is the caller graph for this function:

void ev_view_accessible_set_model	(	EvViewAccessible *	accessible,
		EvDocumentModel *	model
	)

Definition at line 427 of file ev-view-accessible.c.

{
    EvViewAccessiblePrivate* priv = accessible->priv;

    if (priv->model == model)
        return;

    if (priv->model) {
        g_signal_handlers_disconnect_by_data (priv->model, accessible);
        g_object_unref (priv->model);
    }

    priv->model = g_object_ref (model);

    document_changed_cb (model, NULL, accessible);
    g_signal_connect (priv->model, "page-changed",
              G_CALLBACK (page_changed_cb),
              accessible);
    g_signal_connect (priv->model, "notify::document",
              G_CALLBACK (document_changed_cb),
              accessible);
}

Here is the caller graph for this function:

void ev_view_accessible_set_page_range	(	EvViewAccessible *	accessible,
		gint	start,
		gint	end
	)

Definition at line 579 of file ev-view-accessible.c.

{
    gint i;
    AtkObject *page;

    g_return_if_fail (EV_IS_VIEW_ACCESSIBLE (accessible));

    for (i = accessible->priv->start_page; i <= accessible->priv->end_page; i++) {
        if (i < start || i > end) {
            page = g_ptr_array_index (accessible->priv->children, i);
            atk_object_notify_state_change (page, ATK_STATE_SHOWING, FALSE);
        }
    }

    for (i = start; i <= end; i++) {
        if (i < accessible->priv->start_page || i > accessible->priv->end_page) {
            page = g_ptr_array_index (accessible->priv->children, i);
            atk_object_notify_state_change (page, ATK_STATE_SHOWING, TRUE);
        }
    }

    accessible->priv->start_page = start;
    accessible->priv->end_page = end;
}

Here is the caller graph for this function:

void ev_view_accessible_update_element_state	(	EvViewAccessible *	accessible,
		EvMapping *	element,
		gint	element_page
	)

Definition at line 628 of file ev-view-accessible.c.

{
    EvPageAccessible *page;

    page = g_ptr_array_index (accessible->priv->children, element_page);
    ev_page_accessible_update_element_state (page, element);
}

Here is the caller graph for this function:

G_DEFINE_TYPE_WITH_CODE	(	EvViewAccessible	,
		ev_view_accessible	,
		GTK_TYPE_CONTAINER_ACCESSIBLE
	)

Definition at line 71 of file ev-view-accessible.c.

{
    return ev_view_is_caret_navigation_enabled (view) ? view->cursor_page : view->current_page;
}

static void initialize_children ( EvViewAccessible *  self)

static

Definition at line 377 of file ev-view-accessible.c.

{
    gint i;
    EvPageAccessible *child;
    gint n_pages;
    EvDocument *ev_document;

    ev_document = ev_document_model_get_document (self->priv->model);
    n_pages = ev_document_get_n_pages (ev_document);

    self->priv->children = g_ptr_array_new_full (n_pages, (GDestroyNotify) g_object_unref);
    for (i = 0; i < n_pages; i++) {
        child = ev_page_accessible_new (self, i);
        g_ptr_array_add (self->priv->children, child);
    }

        /* When a document is reloaded, it may have less pages.
         * We need to update the end page accordingly to avoid
         * invalid access to self->priv->children
         * See https://bugzilla.gnome.org/show_bug.cgi?id=735744
         */
    if (self->priv->end_page >= n_pages)
        self->priv->end_page = n_pages - 1;
}

Here is the caller graph for this function:

static void page_changed_cb ( EvDocumentModel *  model, gint  old_page, gint  new_page, EvViewAccessible *  accessible  )

static

Definition at line 362 of file ev-view-accessible.c.

{
#if ATK_CHECK_VERSION (2, 11, 2)
    EvView *view;

    view = EV_VIEW (gtk_accessible_get_widget (GTK_ACCESSIBLE (accessible)));
    if (!ev_view_is_caret_navigation_enabled (view))
        g_signal_emit_by_name (accessible, "page-changed", new_page + 1);
#endif
}

Here is the caller graph for this function:

Variable Documentation

const gchar* const ev_view_accessible_action_descriptions[]

static

Initial value:

=
{
    N_("Scroll View Up"),
    N_("Scroll View Down"),
    NULL
}

Definition at line 48 of file ev-view-accessible.c.

const gchar* const ev_view_accessible_action_names[]

static

Initial value:

=
{
    N_("Scroll Up"),
    N_("Scroll Down"),
    NULL
}

Definition at line 41 of file ev-view-accessible.c.