libglom-1.30
1.30.0
|
The Document is like the 'Model' in the Model-View-Controller framework. More...
Public Types | |
enum | LoadFailureCodes { LoadFailureCodes::NONE = 0, LoadFailureCodes::NOT_FOUND = 1, LoadFailureCodes::LAST = 20 } |
typedef sigc::signal< void, bool > | type_signal_modified |
For instance, void on_document_modified(bool modified);. More... | |
typedef sigc::signal< void > | type_signal_forget |
Public Member Functions | |
Document () | |
virtual | ~Document () |
bool | save () |
bool | load (int& failure_code) |
bool | load_from_data (const guchar* data, std::size_t length, int& failure_code) |
bool | get_modified () const |
virtual void | set_modified (bool bVal=true) |
bool | get_is_new () const |
Whether this just a default document. More... | |
void | set_is_new (bool bVal) |
Called by AppWindow_WithDoc::init_create_document(). More... | |
Glib::ustring | get_contents () const |
Glib::ustring | get_file_uri_with_extension (const Glib::ustring& uri) |
Glib::ustring | get_file_uri () const |
virtual void | set_file_uri (const Glib::ustring& file_uri, bool bEnforceFileExtension=false) |
virtual Glib::ustring | get_name () const |
Gets filename part of file_uri, or 'untitled'. More... | |
bool | get_read_only () const |
void | set_read_only (bool bVal) |
void | set_view (ViewBase* pView) |
If you don't want to use a View, then don't use set_view(). More... | |
ViewBase* | get_view () |
void | set_file_extension (const Glib::ustring& strVal) |
Glib::ustring | get_file_extension () const |
type_signal_modified& | signal_modified () |
This signal is emitted when the document has been modified. More... | |
type_signal_forget& | signal_forget () |
This signal is emitted when the view should forget the document. More... | |
Static Public Member Functions | |
static Glib::ustring | util_file_uri_get_name (const Glib::ustring& file_uri, const Glib::ustring& file_extension) |
Protected Member Functions | |
virtual bool | load_after (int& failure_code) |
Allow app to update icons/title bar. More... | |
virtual bool | save_before () |
overrideable. More... | |
bool | read_from_disk (int& failure_code) |
bool | write_to_disk () |
Protected Attributes | |
Glib::ustring | m_strContents |
Glib::ustring | m_file_uri |
Glib::ustring | m_file_extension |
ViewBase* | m_pView |
type_signal_modified | signal_modified_ |
type_signal_forget | signal_forget_ |
bool | m_bModified |
bool | m_bIsNew |
bool | m_bReadOnly |
The Document is like the 'Model' in the Model-View-Controller framework.
Each App should have a Document. Each View gets and sets data in its document.
typedef sigc::signal<void> GlomBakery::Document::type_signal_forget |
typedef sigc::signal<void, bool> GlomBakery::Document::type_signal_modified |
For instance, void on_document_modified(bool modified);.
|
strong |
GlomBakery::Document::Document | ( | ) |
|
virtual |
Reimplemented in Glom::Document.
Glib::ustring GlomBakery::Document::get_contents | ( | ) | const |
Glib::ustring GlomBakery::Document::get_file_extension | ( | ) | const |
Glib::ustring GlomBakery::Document::get_file_uri | ( | ) | const |
Glib::ustring GlomBakery::Document::get_file_uri_with_extension | ( | const Glib::ustring & | uri | ) |
bool GlomBakery::Document::get_is_new | ( | ) | const |
Whether this just a default document.
bool GlomBakery::Document::get_modified | ( | ) | const |
|
virtual |
Gets filename part of file_uri, or 'untitled'.
Reimplemented in Glom::Document.
bool GlomBakery::Document::get_read_only | ( | ) | const |
ViewBase* GlomBakery::Document::get_view | ( | ) |
bool GlomBakery::Document::load | ( | int & | failure_code | ) |
|
protectedvirtual |
Allow app to update icons/title bar.
overrideable. Does anything which should be done after the data has been loaded from disk, but before updating the View.
failure_code | Used to return a custom error code that is understood by your application. This must be greater than zero. |
Reimplemented in GlomBakery::Document_XML.
bool GlomBakery::Document::load_from_data | ( | const guchar * | data, |
std::size_t | length, | ||
int & | failure_code | ||
) |
|
protected |
bool GlomBakery::Document::save | ( | ) |
|
protectedvirtual |
overrideable.
Does anything which should be done before the view has saved its data, before writing to disk..
Reimplemented in GlomBakery::Document_XML.
void GlomBakery::Document::set_file_extension | ( | const Glib::ustring & | strVal | ) |
|
virtual |
Reimplemented in Glom::Document.
void GlomBakery::Document::set_is_new | ( | bool | bVal | ) |
Called by AppWindow_WithDoc::init_create_document().
|
virtual |
Reimplemented in Glom::Document.
void GlomBakery::Document::set_read_only | ( | bool | bVal | ) |
void GlomBakery::Document::set_view | ( | ViewBase* | pView | ) |
If you don't want to use a View, then don't use set_view().
type_signal_forget& GlomBakery::Document::signal_forget | ( | ) |
This signal is emitted when the view should forget the document.
This is used internally, and you should not need to use it yourself.
type_signal_modified& GlomBakery::Document::signal_modified | ( | ) |
This signal is emitted when the document has been modified.
It allows the view to update itself to show the new information.
|
static |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |
|
protected |