From 88356f97d2c9a01082a6f61b62816d7c8cef87a6 Mon Sep 17 00:00:00 2001 From: Christian Stimming Date: Thu, 25 Nov 2010 21:34:25 +0000 Subject: [PATCH] Make prototype for gnc_entry_ledger_get_entry public. Add documentation. git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@19883 57a11ea4-9604-0410-9ed3-97b8803252fd --- src/business/business-ledger/gncEntryLedger.c | 3 ++- src/business/business-ledger/gncEntryLedger.h | 12 +++++++++++- 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/src/business/business-ledger/gncEntryLedger.c b/src/business/business-ledger/gncEntryLedger.c index 1de075b402..666caeb050 100644 --- a/src/business/business-ledger/gncEntryLedger.c +++ b/src/business/business-ledger/gncEntryLedger.c @@ -714,7 +714,7 @@ gnc_entry_ledger_compute_value (GncEntryLedger *ledger, } gboolean -gnc_entry_ledger_get_entry_virt_loc (GncEntryLedger *ledger, GncEntry *entry, +gnc_entry_ledger_get_entry_virt_loc (GncEntryLedger *ledger, const GncEntry *entry, VirtualCellLocation *vcell_loc) { Table *table; @@ -723,6 +723,7 @@ gnc_entry_ledger_get_entry_virt_loc (GncEntryLedger *ledger, GncEntry *entry, if ((ledger == NULL) || (entry == NULL)) return FALSE; + g_assert(vcell_loc); table = ledger->table; diff --git a/src/business/business-ledger/gncEntryLedger.h b/src/business/business-ledger/gncEntryLedger.h index 9ea749dce1..676aa58111 100644 --- a/src/business/business-ledger/gncEntryLedger.h +++ b/src/business/business-ledger/gncEntryLedger.h @@ -119,10 +119,20 @@ gboolean gnc_entry_ledger_check_close (GtkWidget *parent, GncEntryLedger *ledger void gnc_entry_ledger_reset_query (GncEntryLedger *ledger); +/** Returns the GncEntry at the given location, or NULL if the + * location is not valid. */ +GncEntry * gnc_entry_ledger_get_entry (GncEntryLedger *ledger, + VirtualCellLocation vcell_loc); + +/** Returns the GncEntry that represents the blank new line at the + * bottom of the ledger */ GncEntry * gnc_entry_ledger_get_blank_entry (GncEntryLedger *ledger); +/** Looks up the cell location of the given "entry" and writes the + * location into the variable pointed to by vcell_loc (which must be + * non-NULL). Returns TRUE if the entry was found, otherwise FALSE. */ gboolean gnc_entry_ledger_get_entry_virt_loc (GncEntryLedger *ledger, - GncEntry *entry, + const GncEntry *entry, VirtualCellLocation *vcell_loc); void gnc_entry_ledger_delete_current_entry (GncEntryLedger *ledger);