mirror of
https://git.pwmt.org/pwmt/zathura.git
synced 2024-12-28 22:06:02 +01:00
3634636227
The adjustment callbacks act as an interface between position data in
the document object, and the adjustments.
We remove the horizontal centering code, as now it is done by
position_set. Those callbacks should not change the position read from
the document object in any way.
Also, we split the adjustment_value_changed callback into a vertical and
an horizontal version. Previously a single callback was reused for both,
horizontal and vertical. That lead to a subtle problem when coming out
of index mode. What happened was the following:
1. horizontal adjustment bounds change coming out of index mode. This
triggers an hadjustment changed signal.
2. the hadjustment_changed callback handles it, and resets the
hadjustment value, as the bound may have changed. This triggers a
value_changed event.
3. the value_changed callback handles the event, and captures the
position for *BOTH*, horizontal and vertical adjustments, saving
them to the document object.
1..3 is repeated for the vertical adjustment.
Now, if in 3. the horizontal adjustment bounds were not yet updated
after the index mode, we got ourselves at the wrong vertical position.
This race condition is avoided now because both value_changed callbacks
*ONLY* handle their own direction, either vertical or horizontal, not
both.
226 lines
6.8 KiB
C
226 lines
6.8 KiB
C
/* See LICENSE file for license and copyright information */
|
|
|
|
#ifndef CALLBACKS_H
|
|
#define CALLBACKS_H
|
|
|
|
#include <gtk/gtk.h>
|
|
#include <girara/types.h>
|
|
#include <girara/macros.h>
|
|
|
|
#include "internal.h"
|
|
#include "document.h"
|
|
#include "zathura.h"
|
|
|
|
/**
|
|
* Quits the current zathura session
|
|
*
|
|
* @param widget The gtk window of zathura
|
|
* @param zathura Correspondending zathura session
|
|
* @return true if no error occured and the event has been handled
|
|
*/
|
|
gboolean cb_destroy(GtkWidget* widget, zathura_t* zathura);
|
|
|
|
/**
|
|
* This function gets called when the buffer of girara changes
|
|
*
|
|
* @param session The girara session
|
|
*/
|
|
void cb_buffer_changed(girara_session_t* session);
|
|
|
|
/**
|
|
* This function gets called when the value of the horizontal scrollbars
|
|
* changes (e.g.: by scrolling, moving to another page)
|
|
*
|
|
* @param adjustment The hadjustment of the page view
|
|
* @param data NULL
|
|
*/
|
|
void cb_view_hadjustment_value_changed(GtkAdjustment *adjustment, gpointer data);
|
|
|
|
/**
|
|
* This function gets called when the value of the vertical scrollbars
|
|
* changes (e.g.: by scrolling, moving to another page)
|
|
*
|
|
* @param adjustment The vadjustment of the page view
|
|
* @param data NULL
|
|
*/
|
|
void cb_view_vadjustment_value_changed(GtkAdjustment *adjustment, gpointer data);
|
|
|
|
/**
|
|
* This function gets called when the bounds or the page_size of the horizontal
|
|
* scrollbar change (e.g. when the zoom level is changed).
|
|
*
|
|
* It adjusts the value of the horizontal scrollbar, possibly based on its
|
|
* previous adjustment, stored in the tracking adjustment
|
|
* zathura->ui.hadjustment.
|
|
*
|
|
* @param adjustment The horizontal adjustment of a gtkScrolledWindow
|
|
* @param data The zathura instance
|
|
*/
|
|
void cb_view_hadjustment_changed(GtkAdjustment *adjustment, gpointer data);
|
|
|
|
/**
|
|
* This function gets called when the bounds or the page_size of the vertical
|
|
* scrollbar change (e.g. when the zoom level is changed).
|
|
*
|
|
* It adjusts the value of the vertical scrollbar based on its previous
|
|
* adjustment, stored in the tracking adjustment zathura->ui.hadjustment.
|
|
*
|
|
* @param adjustment The vertical adjustment of a gtkScrolledWindow
|
|
* @param data The zathura instance
|
|
*/
|
|
void cb_view_vadjustment_changed(GtkAdjustment *adjustment, gpointer data);
|
|
|
|
/**
|
|
* This function gets called when the program need to refresh the document view.
|
|
*
|
|
* It adjusts the value of the scrollbars, triggering a redraw in the new
|
|
* position.
|
|
*
|
|
* @param view The view GtkWidget
|
|
* @param data The zathura instance
|
|
*/
|
|
void cb_refresh_view(GtkWidget* view, gpointer data);
|
|
|
|
/* This function gets called when the value of the adjustment changes.
|
|
*
|
|
* It updates the value of the tracking adjustment, only if the bounds of the
|
|
* adjustment have not changed (if they did change,
|
|
* cb_adjustment_track_bounds() will take care of updating everything).
|
|
*
|
|
* @param adjustment The adjustment instance
|
|
* @param data The tracking adjustment instance
|
|
*/
|
|
void cb_adjustment_track_value(GtkAdjustment* adjustment, gpointer data);
|
|
|
|
/* This function gets called when the bounds or the page_size of the adjustment
|
|
* change.
|
|
*
|
|
* It updates the value, bounds and page_size of the tracking adjustment.
|
|
*
|
|
* @param adjustment The adjustment instance
|
|
* @param data The tracking adjustment instance
|
|
*/
|
|
void cb_adjustment_track_bounds(GtkAdjustment* adjustment, gpointer data);
|
|
|
|
/**
|
|
* This function gets called when the value of the "pages-per-row"
|
|
* variable changes
|
|
*
|
|
* @param session The current girara session
|
|
* @param name The name of the row
|
|
* @param type The settings type
|
|
* @param value The value
|
|
* @param data Custom data
|
|
*/
|
|
void cb_page_layout_value_changed(girara_session_t* session, const char* name,
|
|
girara_setting_type_t type, void* value, void* data);
|
|
|
|
/**
|
|
* Called when an index element is activated (e.g.: double click)
|
|
*
|
|
* @param tree_view Tree view
|
|
* @param path Path
|
|
* @param column Column
|
|
* @param zathura Zathura session
|
|
*/
|
|
void cb_index_row_activated(GtkTreeView* tree_view, GtkTreePath* path,
|
|
GtkTreeViewColumn* column, void* zathura);
|
|
|
|
/**
|
|
* Called when input has been passed to the sc_follow dialog
|
|
*
|
|
* @param entry The dialog inputbar
|
|
* @param session The girara session
|
|
* @return true if no error occured and the event has been handled
|
|
*/
|
|
bool cb_sc_follow(GtkEntry* entry, girara_session_t* session);
|
|
|
|
/**
|
|
* Called when input has been passed to the sc_display_link dialog
|
|
*
|
|
* @param entry The dialog inputbar
|
|
* @param session The girara session
|
|
* @return true if no error occured and the event has been handled
|
|
*/
|
|
bool cb_sc_display_link(GtkEntry* entry, girara_session_t* session);
|
|
|
|
/**
|
|
* Emitted when file has been changed
|
|
*
|
|
* @param monitor The file monitor
|
|
* @param file The file
|
|
* @param other_file A file or NULL
|
|
* @param event The monitor event
|
|
* @param session The girara session
|
|
*/
|
|
void cb_file_monitor(GFileMonitor* monitor, GFile* file, GFile* other_file,
|
|
GFileMonitorEvent event, girara_session_t* session);
|
|
|
|
/**
|
|
* Callback to read new password for file that should be opened
|
|
*
|
|
* @param entry The password entry
|
|
* @param dialog The dialog information
|
|
* @return true if input has been handled
|
|
*/
|
|
bool cb_password_dialog(GtkEntry* entry, zathura_password_dialog_info_t* dialog);
|
|
|
|
/**
|
|
* Emitted when the view has been resized
|
|
*
|
|
* @param widget View
|
|
* @param allocation Allocation
|
|
* @param zathura Zathura session
|
|
* @return true if signal has been handled successfully
|
|
*/
|
|
bool cb_view_resized(GtkWidget* widget, GtkAllocation* allocation, zathura_t* zathura);
|
|
|
|
/**
|
|
* Emitted when the 'recolor' setting is changed
|
|
*
|
|
* @param session Girara session
|
|
* @param name Name of the setting ("recolor")
|
|
* @param type Type of the setting (BOOLEAN)
|
|
* @param value New value
|
|
* @param data Custom data
|
|
*/
|
|
void cb_setting_recolor_change(girara_session_t* session, const char* name,
|
|
girara_setting_type_t type, void* value, void* data);
|
|
|
|
/**
|
|
* Emitted when the 'recolor-keephue' setting is changed
|
|
*
|
|
* @param session Girara session
|
|
* @param name Name of the setting ("recolor")
|
|
* @param type Type of the setting (BOOLEAN)
|
|
* @param value New value
|
|
* @param data Custom data
|
|
*/
|
|
void cb_setting_recolor_keep_hue_change(girara_session_t* session, const char* name,
|
|
girara_setting_type_t type, void* value, void* data);
|
|
|
|
|
|
/**
|
|
* Unknown command handler which is used to handle the strict numeric goto
|
|
* command
|
|
*
|
|
* @param session The girara session
|
|
* @param input The command input
|
|
* @return true if the input has been handled
|
|
*/
|
|
bool cb_unknown_command(girara_session_t* session, const char* input);
|
|
|
|
/**
|
|
* Emitted when text has been selected in the page widget
|
|
*
|
|
* @param widget page view widget
|
|
* @param text selected text
|
|
* @param data user data
|
|
*/
|
|
void cb_page_widget_text_selected(ZathuraPage* page, const char* text,
|
|
void* data);
|
|
|
|
void cb_page_widget_image_selected(ZathuraPage* page, GdkPixbuf* pixbuf,
|
|
void* data);
|
|
|
|
#endif // CALLBACKS_H
|