Files
l7/L7/LNavigator.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

97 lines
2.6 KiB
C++

/*
* File: LNavigator.h
* Author: SET - nmset@netcourrier.com
* License : LGPL version 2.1
* Copyright SET, M. D. - © 2014
*
* Created on 4 juin 2014, 14:56
*/
#ifndef LNAVIGATOR_H
#define LNAVIGATOR_H
#include <wx/wx.h>
#include "LResultSet.h"
class NavigatorRsEVH;
/**
* This combined control displays an action bar and a navigation bar.
* These contains standard buttons to interact with a resultset.
*
* The action bar can
* move the resultset to the insert row,
* save any edits,
* cancel any edits,
* refresh the resultset,
* delete the current record.
*
* The navigation bar is used to move the resultset's cursor
* and displays the current position.
*/
class LNavigator : public wxPanel
{
public:
LNavigator(wxWindow* parent, wxWindowID id = wxID_ANY);
virtual ~LNavigator();
void SetResultSet(LResultSet * newResultSet);
LResultSet* GetResultSet() const;
void ShowActionBar(bool show) const;
void ShowNavigationBar(bool show) const;
void ShowButtonAddNew(bool show) const;
void ShowButtonSave(bool show) const;
void ShowButtonCancel(bool show) const;
void ShowButtonRefresh(bool show) const;
void ShowButtonDelete(bool show) const;
private:
wxBoxSizer* m_vsz;
wxBoxSizer* m_hsz1;
wxButton* m_btnNew;
wxButton* m_btnSave;
wxButton* m_btnCancel;
wxButton* m_btnRefresh;
wxButton* m_btnDelete;
wxBoxSizer* m_hsz2;
wxButton* m_btnFirst;
wxButton* m_btnPrevious;
wxStaticText* m_lbl;
wxButton* m_btnNext;
wxButton* btnLast;
wxWeakRef<LResultSet> m_rs;
NavigatorRsEVH * m_evh;
void OnButtonNew(wxCommandEvent& evt);
void OnButtonSave(wxCommandEvent& evt);
void OnButtonCancel(wxCommandEvent& evt);
void OnButtonRefresh(wxCommandEvent& evt);
void OnButtonDelete(wxCommandEvent& evt);
void OnBtnFirst(wxCommandEvent& evt);
void OnBtnPrevious(wxCommandEvent& evt);
void OnBtnNext(wxCommandEvent& evt);
void OnBtnLast(wxCommandEvent& evt);
};
//////////////////////////////////////////////////////////////////////////////
/**
* A private resultset event handler for LNavigator. All functions are declared private.
* Don't use it.
*/
class NavigatorRsEVH : public LResultSetEvent
{
friend class LNavigator;
private:
NavigatorRsEVH(wxStaticText * newLbl);
virtual ~NavigatorRsEVH();
void Initialised(LResultSet* caller);
void AfterChangeRow(LResultSet* caller);
void AfterAction(LResultSet * caller, ACTIONS action);
wxStaticText * m_lbl;
void UpdateLocation(const LResultSet* caller);
};
#endif /* LNAVIGATOR_H */