Package qubx :: Module faces :: Class FilesFace
[hide private]
[frames] | no frames]

Class FilesFace

source code

        object --+                            
                 |                            
        ??.GObject --+                        
                     |                        
            gtk.Object --+                    
                         |                    
        object --+       |                    
                 |       |                    
gobject.GInterface --+   |                    
                     |   |                    
  atk.ImplementorIface --+                    
                         |                    
        object --+       |                    
                 |       |                    
gobject.GInterface --+   |                    
                     |   |                    
         gtk.Buildable --+                    
                         |                    
                gtk.Widget --+                
                             |                
                 gtk.Container --+            
                                 |            
                object --+       |            
                         |       |            
        gobject.GInterface --+   |            
                             |   |            
                gtk.Orientable --+            
                                 |            
                           gtk.Box --+        
                                     |        
                              gtk.VBox --+    
                                         |    
                                      Face --+
                                             |
                                            FilesFace
Known Subclasses:

Base class for a widget that manages multiple open files; e.g Data, Model. Provides a menu of open files, file switching, a file menu, open and save dialogs,

Instance Methods [hide private]
 
__init__(self, name, table, ViewClass, menu_width=32, popup_color=('faces.menu.file', (0, 1, 0, 1)), global_name='')
x.__init__(...) initializes x; see help(type(x)) for signature
source code
 
__buildMenu(self) source code
 
_sensitize(self) source code
 
on_popup_file(self) source code
 
set_file(self, x) source code
 
set_index(self, x, force=False) source code
 
__onInsert(self, i, undoing) source code
 
make_view(self, table) source code
 
make_page(self, view) source code
 
__onRemoved(self, i, undoing) source code
 
__onSelect(self, i, field_name, sender) source code
 
_onSwitchPage(self, pages, page, page_num) source code
 
_onItemNew(self, item) source code
 
_onItemOpen(self, item) source code
 
_onItemSave(self, item) source code
 
_onItemSaveAs(self, item) source code
 
saveAs(self, fname=None) source code
 
_onItemRevert(self, item) source code
 
_onItemClose(self, item) source code
 
_onItemCloseAll(self, item) source code
 
_onItemPrint(self, item) source code
 
close(self) source code
 
close_one(self) source code
 
on_pre_close(self) source code
 
save(self, path=None) source code
 
on_pre_save(self, fname) source code
 
promptSave(self)
Returns True if no changes, or asks "save changes" then returns True unless they chose cancel.
source code
 
close_down(self)
Attempts to close all files; returns True if successful.
source code
 
show_file(self, name) source code
 
add_recent(self, path) source code
 
do_print(self)
unimplemented.
source code
 
new(self)
Override this method to create a new file and add it to table.
source code
 
open(self, path=None)
Override this method to open the file at path and add it to table.
source code
 
is_changed(self)
Override this method to report if the current file has been modified.
source code
 
can_save(self)
Override this method to report if the file can be saved.
source code
 
can_revert(self)
Override this method to report if the file can be reverted to saved.
source code
 
init_file(self, file)
Override this method to do things when the file comes onscreen (e.g.
source code
 
done_file(self, file, view)
Override this method to do things when the file goes offscreen.
source code
 
get_open_filters(self)
Override this method to return a list of (".extension", gtk.FileFilter) to add to the open file dialog.
source code
 
get_save_filters(self)
Override this method to return a list of (".extension", gtk.FileFilter) to add to the save file dialog; By default, uses the open_filters.
source code

Inherited from Face: onShow, request_show, set_parent_window, set_pop_prefs, set_showing

Inherited from gtk.VBox: __iter__

Inherited from gtk.Box: get_homogeneous, get_spacing, pack_end, pack_end_defaults, pack_start, pack_start_defaults, query_child_packing, reorder_child, set_child_packing, set_homogeneous, set_spacing

Inherited from gtk.Container: __len__, __nonzero__, add, add_with_properties, check_resize, child_get, child_get_property, child_set, child_set_property, child_type, children, do_add, do_check_resize, do_child_type, do_composite_name, do_forall, do_get_child_property, do_remove, do_set_child_property, do_set_focus_child, forall, foreach, get_border_width, get_children, get_focus_chain, get_focus_child, get_focus_hadjustment, get_focus_vadjustment, get_resize_mode, install_child_property, list_child_properties, propagate_expose, remove, resize_children, set_border_width, set_focus_chain, set_focus_child, set_focus_hadjustment, set_focus_vadjustment, set_reallocate_redraws, set_resize_mode, unset_focus_chain

Inherited from gtk.Widget: activate, add_accelerator, add_events, add_mnemonic_label, can_activate_accel, child_focus, child_notify, class_path, create_pango_context, create_pango_layout, destroy, do_button_press_event, do_button_release_event, do_can_activate_accel, do_client_event, do_composited_changed, do_configure_event, do_delete_event, do_destroy_event, do_direction_changed, do_drag_begin, do_drag_data_delete, do_drag_data_get, do_drag_data_received, do_drag_drop, do_drag_end, do_drag_leave, do_drag_motion, do_enter_notify_event, do_event, do_expose_event, do_focus, do_focus_in_event, do_focus_out_event, do_get_accessible, do_grab_broken_event, do_grab_focus, do_grab_notify, do_hide, do_hide_all, do_hierarchy_changed, do_key_press_event, do_key_release_event, do_leave_notify_event, do_map, do_map_event, do_mnemonic_activate, do_motion_notify_event, do_no_expose_event, do_parent_set, do_popup_menu, do_property_notify_event, do_proximity_in_event, do_proximity_out_event, do_realize, do_screen_changed, do_scroll_event, do_selection_clear_event, do_selection_get, do_selection_notify_event, do_selection_received, do_selection_request_event, do_show, do_show_all, do_show_help, do_size_allocate, do_size_request, do_state_changed, do_style_set, do_unmap, do_unmap_event, do_unrealize, do_visibility_notify_event, do_window_state_event, drag_begin, drag_check_threshold, drag_dest_add_image_targets, drag_dest_add_text_targets, drag_dest_add_uri_targets, drag_dest_find_target, drag_dest_get_target_list, drag_dest_get_track_motion, drag_dest_set, drag_dest_set_proxy, drag_dest_set_target_list, drag_dest_set_track_motion, drag_dest_unset, drag_get_data, drag_highlight, drag_source_add_image_targets, drag_source_add_text_targets, drag_source_add_uri_targets, drag_source_get_target_list, drag_source_set, drag_source_set_icon, drag_source_set_icon_name, drag_source_set_icon_pixbuf, drag_source_set_icon_stock, drag_source_set_target_list, drag_source_unset, drag_unhighlight, draw, ensure_style, error_bell, event, freeze_child_notify, get_accessible, get_action, get_activate_signal, get_allocation, get_ancestor, get_app_paintable, get_can_default, get_can_focus, get_child_requisition, get_child_visible, get_clipboard, get_colormap, get_composite_name, get_direction, get_display, get_double_buffered, get_events, get_extension_events, get_has_tooltip, get_has_window, get_mapped, get_modifier_style, get_name, get_no_show_all, get_pango_context, get_parent, get_parent_window, get_pointer, get_realized, get_receives_default, get_requisition, get_root_window, get_screen, get_sensitive, get_settings, get_size_request, get_snapshot, get_state, get_style, get_tooltip_markup, get_tooltip_text, get_tooltip_window, get_toplevel, get_visible, get_visual, get_window, grab_add, grab_default, grab_focus, grab_remove, has_default, has_focus, has_grab, has_rc_style, has_screen, hide, hide_all, hide_on_delete, input_shape_combine_mask, intersect, is_ancestor, is_composited, is_drawable, is_focus, is_sensitive, is_toplevel, keynav_failed, list_accel_closures, list_mnemonic_labels, map, menu_get_for_attach_widget, mnemonic_activate, modify_base, modify_bg, modify_cursor, modify_fg, modify_font, modify_style, modify_text, path, queue_clear, queue_clear_area, queue_draw, queue_draw_area, queue_resize, queue_resize_no_redraw, rc_get_style, realize, region_intersect, remove_accelerator, remove_mnemonic_label, render_icon, reparent, reset_rc_styles, reset_shapes, selection_add_target, selection_add_targets, selection_clear_targets, selection_convert, selection_owner_set, selection_remove_all, send_expose, send_focus_change, set_accel_path, set_activate_signal, set_allocation, set_app_paintable, set_can_default, set_can_focus, set_child_visible, set_colormap, set_composite_name, set_direction, set_double_buffered, set_events, set_extension_events, set_has_tooltip, set_has_window, set_mapped, set_name, set_no_show_all, set_parent, set_realized, set_receives_default, set_redraw_on_allocate, set_scroll_adjustments, set_sensitive, set_set_scroll_adjustments_signal, set_size_request, set_state, set_style, set_tooltip_markup, set_tooltip_text, set_tooltip_window, set_uposition, set_usize, set_visible, set_window, shape_combine_mask, show, show_all, show_now, size_allocate, size_request, style_attach, style_get_property, thaw_child_notify, translate_coordinates, trigger_tooltip_query, unmap, unparent, unrealize

Inherited from gtk.Object: do_destroy, flags, remove_data, remove_no_notify, set_flags, unset_flags

Inherited from unreachable.GObject: __copy__, __deepcopy__, __delattr__, __eq__, __gdoc__, __ge__, __gobject_init__, __gt__, __hash__, __le__, __lt__, __ne__, __new__, __repr__, __setattr__, chain, connect, connect_after, connect_object, connect_object_after, disconnect, disconnect_by_func, emit, emit_stop_by_name, freeze_notify, get_data, get_properties, get_property, handler_block, handler_block_by_func, handler_disconnect, handler_is_connected, handler_unblock, handler_unblock_by_func, notify, props, set_data, set_properties, set_property, stop_emission, thaw_notify, weak_ref

Inherited from atk.ImplementorIface: ref_accessible

Inherited from gtk.Buildable: add_child, construct_child, do_add_child, do_construct_child, do_get_internal_child, do_parser_finished, do_set_name, get_internal_child, parser_finished

Inherited from gtk.Orientable: get_orientation, set_orientation

Inherited from object: __format__, __getattribute__, __reduce__, __reduce_ex__, __sizeof__, __str__, __subclasshook__

Class Variables [hide private]
  __explore_featured = ['file', 'index', 'view', 'table', 'views...

Inherited from gtk.VBox: __gtype__

Instance Variables [hide private]
  file
object with fields "path", "save(path)", "saveAs(path)", "revert_to_saved()"
  index
index of currently showing file
  view
ToolSpace for editing file; must have .controls as primary LayerSet
  OnChange
WeakEvent(FilesFace, file) called when index changes or file is edited
  OnClosing
WeakEvent(index) before close
  OnSave
WeakEvent(FilesFace, file, path) called after successful save
  OnSwitch
WeakEvent(FilesFace, file) called when index changes
  lbls
list of each file's tab's gtk.Label
  names
list of each file's name
  page0
a blank page shown when no file is open, constructed by ViewClass()
  table
qubx.ObjectTable containing files
  views
list of each file's view

Inherited from Face: icon, menubar, showing, tab_sublayers

Properties [hide private]

Inherited from Face: parent_window, pop_prefs

Inherited from gtk.Container: border_width, focus_child, has_focus_chain, need_resize, reallocate_redraws, resize_mode

Inherited from gtk.Widget: allocation, name, parent, requisition, saved_state, state, style, window

Inherited from unreachable.GObject: __grefcount__

Inherited from object: __class__

Method Details [hide private]

__init__(self, name, table, ViewClass, menu_width=32, popup_color=('faces.menu.file', (0, 1, 0, 1)), global_name='')
(Constructor)

source code 

x.__init__(...) initializes x; see help(type(x)) for signature

Parameters:
  • name - the name of this face; e.g. Data
  • table - a qubx.ObjectTable of files
  • ViewClass - class or function(files_table) which instantiates a ToolSpace, subsequently assigned .file
  • menu_width - the file switcher is this many 'M's wide, at lower-left
  • popup_color - COLORREF of the inscribed-triangle File menu
Overrides: object.__init__

init_file(self, file)

source code 

Override this method to do things when the file comes onscreen (e.g. subscribe to its events).


Class Variable Details [hide private]

__explore_featured

Value:
['file',
 'index',
 'view',
 'table',
 'views',
 'names',
 'page_list',
 'path',
...

Instance Variable Details [hide private]

file

object with fields "path", "save(path)", "saveAs(path)", "revert_to_saved()"
Get Method:
unreachable(self)
Set Method:
unreachable(self, x)

index

index of currently showing file
Get Method:
unreachable(self)
Set Method:
unreachable(self, x)

view

ToolSpace for editing file; must have .controls as primary LayerSet
Get Method:
unreachable(self)