IntenseFinance/gnucash
3
0
Fork 0
mirror of https://github.com/Gnucash/gnucash.git synced 2025-02-25 18:55:30 -06:00
Code Issues Packages Projects Releases Wiki Activity

documentation/cosmetic cleanup

Browse Source 
git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@9423 57a11ea4-9604-0410-9ed3-97b8803252fd
This commit is contained in:
Linas Vepstas 2003-09-27 10:38:29 +00:00
parent f8bfae598f
commit e3b49bc44d
2 changed files with 23 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
src/engine/qofobject.h
View File

@ -44,8 +44,9 @@ typedef void (*QofForeachBackendTypeCB) (QofIdTypeConst type,
gpointer backend_data, gpointer backend_data,
gpointer user_data); gpointer user_data);
/* This is the Object Object descriptor */ /** This is the QofObject Class descriptor */
struct _QofObject { struct _QofObject
{
gint interface_version; /* of this object interface */ gint interface_version; /* of this object interface */
QofIdType name; /* the Object's QOF_ID */ QofIdType name; /* the Object's QOF_ID */
const char * type_label; /* "Printable" type-label string */ const char * type_label; /* "Printable" type-label string */
@ -59,7 +60,7 @@ struct _QofObject {
void (*book_end)(QofBook *); void (*book_end)(QofBook *);
/* Determine if there are any dirty items in this book */ /* Determine if there are any dirty items in this book */
gboolean (*is_dirty)(QofBook *); gboolean (*is_dirty)(QofBook *);
/* Mark this object's book clean (for after a load) */ /* Mark this object's book clean (for after a load) */
void (*mark_clean)(QofBook *); void (*mark_clean)(QofBook *);

35
src/engine/qofqueryobject.h
View File

@ -30,6 +30,9 @@
#include "qofid.h" #include "qofid.h"
/** Core types of objects that can be used in parameters.
* Note that QofIdTypes may also be used. */
#define QOF_TYPE_STRING "string" #define QOF_TYPE_STRING "string"
#define QOF_TYPE_DATE "date" #define QOF_TYPE_DATE "date"
#define QOF_TYPE_NUMERIC "numeric" #define QOF_TYPE_NUMERIC "numeric"
@ -58,7 +61,7 @@ typedef gpointer (*QofAccessFunc)(gpointer);
* *
* -- param_name is the name of the parameter. * -- param_name is the name of the parameter.
* -- param_type is the type of the parameter, which can be either another * -- param_type is the type of the parameter, which can be either another
* object or it can be a core data type. * object (QofIdType) or it can be a core data type (QofType).
* -- param_getgcn is the function to actually obtain the parameter * -- param_getgcn is the function to actually obtain the parameter
*/ */
typedef struct _QofParam typedef struct _QofParam
@ -71,11 +74,11 @@ typedef struct _QofParam
/** This function is the default sort function for a particular object type */ /** This function is the default sort function for a particular object type */
typedef int (*QofSortFunc)(gpointer, gpointer); typedef int (*QofSortFunc)(gpointer, gpointer);
/** This function registers a new Gnucash Object with the QofQuery /** This function registers a new object class with the QofQuery
* subsystem. In particular it registers the set of parameters and * subsystem. In particular it registers the set of parameters and
* converters to query the type-specific data. Both "params" and * converters to query the type-specific data. The "params" argument
* "converters" are NULL-terminated arrays of structures. Either * must be a NULL-terminated array of QofParam. It may be NULL if
* argument may be NULL if there is nothing to be registered. * there are no paramters to be registered.
*/ */
void qof_query_object_register (QofIdTypeConst obj_name, void qof_query_object_register (QofIdTypeConst obj_name,
QofSortFunc default_sort_fcn, QofSortFunc default_sort_fcn,
@ -83,21 +86,21 @@ void qof_query_object_register (QofIdTypeConst obj_name,
/** An example: /** An example:
* *
* #define MY_QUERY_OBJ_MEMO "memo" * #define MY_OBJ_MEMO "memo"
* #define MY_QUERY_OBJ_VALUE "value" * #define MY_OBJ_VALUE "value"
* #define MY_QUERY_OBJ_DATE "date" * #define MY_OBJ_DATE "date"
* #define MY_QUERY_OBJ_ACCOUNT "account" * #define MY_OBJ_ACCOUNT "account"
* #define MY_QUERY_OBJ_TRANS "trans" * #define MY_OBJ_TRANS "trans"
* *
* static QofParam myParams[] = { * static QofParam myParams[] = {
* { MY_QUERY_OBJ_MEMO, QOF_TYPE_STRING, myMemoGetter }, * { MY_OBJ_MEMO, QOF_TYPE_STRING, myMemoGetter },
* { MY_QUERY_OBJ_VALUE, QOF_TYPE_NUMERIC, myValueGetter }, * { MY_OBJ_VALUE, QOF_TYPE_NUMERIC, myValueGetter },
* { MY_QUERY_OBJ_DATE, QOF_TYPE_DATE, myDateGetter }, * { MY_OBJ_DATE, QOF_TYPE_DATE, myDateGetter },
* { MY_QUERY_OBJ_ACCOUNT, GNC_ID_ACCOUNT, myAccountGetter }, * { MY_OBJ_ACCOUNT, GNC_ID_ACCOUNT, myAccountGetter },
* { MY_QUERY_OBJ_TRANS, GNC_ID_TRANS, myTransactionGetter }, * { MY_OBJ_TRANS, GNC_ID_TRANS, myTransactionGetter },
* NULL }; * NULL };
* *
* qof_query_object_register ("myObjectName", myQueryObjectCompare, * qof_query_object_register ("myObjectName", myObjectCompare,
* &myParams); * &myParams);
*/ */