samples/db/listdb.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        listdb.h
   3 // Purpose:     wxWindows database demo app
   4 // Author:      George Tasker
   5 // Modified by:
   6 // Created:     1996
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 1996 Remstar International, Inc.
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifdef __GNUG__
  13 #pragma interface "listdb.h"
  14 #endif
  15
  16 /*
  17         Contains dialog class for creating a data table lookup listbox
  18 */
  19
  20 #ifndef LISTDB_DOT_H
  21 #define LISTDB_DOT_H
  22
  23
  24 #include <wx/dbtable.h>
  25
  26 const int LOOKUP_COL_LEN = 250;
  27
  28 // Global database connection
  29 extern wxDB *READONLY_DB;
  30
  31 // Clookup class
  32 class Clookup : public wxTable
  33 {
  34         public:
  35
  36                 char lookupCol[LOOKUP_COL_LEN+1];
  37
  38                 Clookup(char *tblName, char *colName);
  39
  40 };  // Clookup
  41
  42 // Clookup2 class
  43 class Clookup2 : public wxTable
  44 {
  45         public:
  46
  47                 char lookupCol1[LOOKUP_COL_LEN+1];
  48                 char lookupCol2[LOOKUP_COL_LEN+1];
  49
  50                 Clookup2(char *tblName, char *colName1, char *colName2, wxDB *pDb);
  51
  52 };  // Clookup2
  53
  54 class ClookUpDlg : public wxDialog
  55 {
  56         private:
  57                 bool                     widgetPtrsSet;
  58                 int                      currentCursor;
  59                 Clookup         *lookup;
  60                 Clookup2                *lookup2;
  61                 int                      noDisplayCols;
  62                 int                      col1Len;
  63
  64                 wxListBox       *pLookUpSelectList;
  65                 wxButton                *pLookUpOkBtn;
  66                 wxButton                *pLookUpCancelBtn;
  67
  68         public:
  69
  70                 // This is a generic lookup constructor that will work with any table and any column
  71                 ClookUpDlg(wxWindow     *parent,
  72                                           char          *windowTitle,
  73                                           char          *tableName,
  74                                           char          *colName,
  75                                           char          *where,
  76                                           char          *orderBy);
  77
  78                 //
  79                 // This is a generic lookup constructor that will work with any table and any column.
  80                 // It extends the capabilites of the lookup dialog in the following ways:
  81                 //
  82                 //      1) 2 columns rather than one
  83                 // 2) The ability to select DISTINCT column values
  84                 //
  85                 // Only set distinctValues equal to true if necessary.  In many cases, the constraints
  86                 // of the index(es) will enforce this uniqueness.  Selecting DISTINCT does require
  87                 // overhead by the database to ensure that all values returned are distinct.  Therefore,
  88                 // use this ONLY when you need it.
  89                 //
  90                 // For complicated queries, you can pass in the sql select statement.  This would be
  91                 // necessary if joins are involved since by default both columns must come from the
  92                 // same table.
  93                 //
  94                 // If you do query by sql statement, you must pass in the maximum length of column1,
  95                 // since it cannot be derived when you query using your own sql statement.
  96                 //
  97                 // The optional database connection can be used if you'd like the lookup class
  98                 // to use a database pointer other than the global READONLY_DB.  This is necessary if
  99                 // records are being saved, but not committed to the db, yet should be included
 100                 // in the lookup window.
 101                 //
 102                 ClookUpDlg(wxWindow     *parent,
 103                                           char          *windowTitle,
 104                                           char          *tableName,
 105                                           char          *dispCol1,                                      // Must have at least 1 display column
 106                                           char          *dispCol2,                                      // Optional
 107                                           char          *where,
 108                                           char          *orderBy,
 109                                           bool           distinctValues,                        // e.g. SELECT DISTINCT ...
 110                                           char          *selectStmt = 0,                        // If you wish to query by SQLstmt (complicated lookups)
 111                                           int                    maxLenCol1 = 0,                        // Mandatory if querying by SQLstmt
 112                                           wxDB                  *pDb = READONLY_DB,             // Database connection pointer
 113                                           bool           allowOk                = TRUE);                // is the OK button enabled
 114
 115                 void     OnButton( wxCommandEvent &event );
 116                 void            OnCommand(wxWindow& win, wxCommandEvent& event);
 117                 void            OnClose(wxCloseEvent& event);
 118                 void            OnActivate(bool) {};  // necessary for hot keys
 119
 120 DECLARE_EVENT_TABLE()
 121 };
 122
 123 #define LOOKUP_DIALOG                   500
 124
 125 #define LOOKUP_DIALOG_SELECT            501
 126 #define LOOKUP_DIALOG_OK                502
 127 #define LOOKUP_DIALOG_CANCEL            503
 128
 129 #endif  // LISTDB_DOT_H
 130
 131 // ************************************ listdb.h *********************************