Files
l7/L7/LLightResultSet.h
SET aaacf88071 Added classes to manage simple tabular data of known structure using a
popup containing a wxGrid object.

BasePicker : Abstract class adding a popup to wxPickerBase  styled with
a wxTextCtrl.
BaseGridPicker : Abstract class adding a wxGrid in the popup.

JsonGridPickerCtrl : UI control storing the tabular data in a JSON
array.
LBoundJsonGridPicker : connect JsonGridPicker to database.
LGridJsonCellEditor : use LBoundJsonGridPicker in other wxGrid objects.
LGridJsonCellRenderer : render cell JSON data.

XmlGridPickerCtrl : UI control storing the tabular data in as XML
document.
LBoundXmlGridPicker : connect XmlGridPicker to database.
LGridXmlCellEditor : grid editor for LBoundXmlGridPicker.
LGridXmlCellRenderer : grid renderer for LBoundXmlGridPicker.

JsonHelper and XmlHelper : for applications to quickly get intent value
from database data..

The structure of managed tabular data :

Column 1 : Intent - this is what we want to store/edit. This can be
telephone numbers, email addresses, instant messaging addresses...
any single line piece of information that can exist many times for one
entity (person, company...).
Column 2 : Type - A short description of the intent : 'Home, Work,
Mobile, Fax, Other...'. It is displayed in a non editable wxComboBox.
Column 3 : Preferred - One line of data can be selected as the preferred
one. It is not mandatory, but it must be a single choice.
Column 4 : Notes - single line notes.

Adjust sql scripts and L7.dox.
Applied ANSI formatting style to all files.

Other changes :

Work around a nasty misbehavior.
Grid columns edited by a translated combobox expect full string
data as cell values. LResultSet::BEData() will report these mapped strings,
instead of database real data. LBoundComboBox::IsDirty() will always be
true even if the editor is unchanged once created.
Simplest workaround : disconnect m_BoundComboBox if unchanged.

LGridTextEditor::ProvideFormEditor() : set the form editor's value
explicitely.; wxTextCtrl does not interpret data it receives

LBoundControl::SetNull must be void.

LBoundGrid : Unbind:: instructions should limit to the widget's id, like Bind::

LConnection::GetReturnedKeys should return NULL.
LConnection::SetData should return void.

Notes : wxJSON must be configured with the same prefix as wxWidgets,
here /usr/local/{wxWidgets,wxWidgets-Release}.
2019-12-23 08:12:01 +01:00

100 lines
2.4 KiB
C++

/*
* File: LLightResultSet.h
* Author: SET - nmset@netcourrier.com
* License : LGPL version 2.1
* Copyright SET, M. D. - © 2014
*
* Created on 28 mai 2014, 14:40
*/
#ifndef LLIGHTRESULTSET_H
#define LLIGHTRESULTSET_H
/* Added to be able to use derived classes independantly
* If xConnection and xResultSet classes are included in some project,
* the compiler would complain ofan undeclared wxWeakRef.
*/
#include <wx/wx.h>
#include <wx/weakref.h>
#include "LConnection.h"
/**
* An abstract class to scroll through data obtained after running an SQL query.
* Does not interact with GUI controls.
*
* Does not output any messages.
*
* Does not modify data.
*/
class LLightResultSet : public wxTrackable
{
public:
LLightResultSet();
LLightResultSet(LConnection * newConnection);
virtual ~LLightResultSet();
virtual bool SetSQL(const wxString& newSql) = 0;
/**
* Updates the SQL statement without running it.
* @param newSql
*/
void UpdateSQL(const wxString& newSql)
{
m_curSql = newSql;
}
const wxString& GetSQL() const
{
return m_curSql;
}
void SetConnection(LConnection * newConnection)
{
m_conn = newConnection;
}
const LConnection * GetConnection() const
{
return m_conn;
}
virtual bool HasData() const = 0;
virtual bool Absolute(const unsigned int newRowIndex) = 0;
virtual bool IsFirst() const = 0;
virtual bool IsLast() const = 0;
virtual bool First() = 0;
virtual bool Next() = 0;
virtual bool Previous() = 0;
virtual bool Last() = 0;
/**
* Returns the cursor position from 0 to (GetRowCount() - 1).
*
* Returns -1 if there's no data.
*/
const int GetRow() const
{
return m_cursor;
}
virtual const unsigned int GetRowCount() const = 0;
virtual const unsigned int GetColumnCount() const = 0;
virtual const wxString GetColumnName(const unsigned int colIndex) const = 0;
virtual const int GetColumnIndex(const wxString& colName) const = 0;
virtual const wxAny GetData(const wxString& colName) const = 0;
virtual const wxAny GetData(const unsigned int rowIdx, const unsigned int colIdx) const = 0;
protected:
bool m_initialised;
wxString m_curSql;
void * m_rs;
wxWeakRef<LConnection> m_conn;
int m_cursor;
virtual bool RunSQL() = 0;
private:
};
#endif /* LLIGHTRESULTSET_H */