1\section{\class{wxQueryCol}}\label{wxquerycol} 2 3Every ODBC data column is represented by an instance of this class. 4 5\wxheading{Derived from} 6 7\helpref{wxObject}{wxobject} 8 9\wxheading{Include files} 10 11<wx/odbc.h> 12 13\wxheading{See also} 14 15\overview{wxQueryCol overview}{wxquerycoloverview}, \overview{wxDatabase overview}{wxdatabaseoverview} 16 17\latexignore{\rtfignore{\wxheading{Members}}} 18 19\membersection{wxQueryCol::wxQueryCol} 20 21\func{void}{wxQueryCol}{\void} 22 23Constructor. Sets the attributes of the column to default values. 24 25\membersection{wxQueryCol::\destruct{wxQueryCol}} 26 27\func{void}{\destruct{wxQueryCol}}{\void} 28 29Destructor. Deletes the wxQueryField list. 30 31\membersection{wxQueryCol::BindVar} 32 33\func{void *}{BindVar}{\param{void *}{v}, \param{long}{ sz}} 34 35Binds a user-defined variable to a column. Whenever a column is bound to a 36variable, it will automatically copy the data of the current field into this 37buffer (to a maximum of {\it sz} bytes). 38 39\membersection{wxQueryCol::FillVar} 40 41\func{void}{FillVar}{\param{int}{ recnum}} 42 43Fills the bound variable with the data of the field recnum. When no variable 44is bound to the column nothing will happen. 45 46\membersection{wxQueryCol::GetData} 47 48\func{void *}{GetData}{\param{int}{ field}} 49 50Returns a pointer to the data of the field. 51 52\membersection{wxQueryCol::GetName} 53 54\func{wxString}{GetName}{\void} 55 56Returns the name of a column. 57 58\membersection{wxQueryCol::GetType} 59 60\func{short}{GetType}{\void} 61 62Returns the data type of a column. 63 64\membersection{wxQueryCol::GetSize} 65 66\func{long}{GetSize}{\param{int}{ field}} 67 68Return the size of the data of the field field. 69 70\membersection{wxQueryCol::IsRowDirty} 71 72\func{bool}{IsRowDirty}{\param{int}{ field}} 73 74Returns true if the given field has been changed, but not saved. 75 76\membersection{wxQueryCol::IsNullable} 77 78\func{bool}{IsNullable}{\void} 79 80Returns true if a column may contain no data. 81 82\membersection{wxQueryCol::AppendField} 83 84\func{void}{AppendField}{\param{void *}{buf}, \param{long}{ len}} 85 86Appends a wxQueryField instance to the field list of the column. {\it len} bytes from\rtfsp 87{\it buf} will be copied into the field's buffer. 88 89\membersection{wxQueryCol::SetData} 90 91\func{bool}{SetData}{\param{int}{ field}, \param{void *}{buf}, \param{long}{ len}} 92 93Sets the data of a field. This function finds the wxQueryField corresponding to\rtfsp 94{\it field} and calls wxQueryField::SetData with {\it buf} and {\it len} arguments. 95 96\membersection{wxQueryCol::SetName} 97 98\func{void}{SetName}{\param{const wxString\& }{name}} 99 100Sets the name of a column. Only useful when creating new tables or 101appending columns. 102 103\membersection{wxQueryCol::SetNullable} 104 105\func{void}{SetNullable}{\param{bool}{ nullable}} 106 107Determines whether a column may contain no data. Only useful when creating new tables or 108appending columns. 109 110\membersection{wxQueryCol::SetFieldDirty} 111 112\func{void}{SetFieldDirty}{\param{int}{ field}, \param{bool }{dirty = true}} 113 114Sets the dirty tag of a given field. 115 116\membersection{wxQueryCol::SetType} 117 118\func{void}{SetType}{\param{short}{ type}} 119 120Sets the data type of a column. Only useful when creating new tables or 121appending columns. 122 123\section{\class{wxQueryField}}\label{wxqueryfield} 124 125Represents the data item for one or several columns. 126 127\wxheading{Derivation} 128 129\helpref{wxObject}{wxobject} 130 131\wxheading{See also} 132 133\overview{wxQueryField overview}{wxqueryfieldoverview}, \overview{wxDatabase overview}{wxdatabaseoverview} 134 135\latexignore{\rtfignore{\wxheading{Members}}} 136 137\membersection{wxQueryField::wxQueryField} 138 139\func{}{wxQueryField}{\void} 140 141Constructor. Sets type and size of the field to default values. 142 143\membersection{wxQueryField::\destruct{wxQueryField}} 144 145\func{}{\destruct{wxQueryField}}{\void} 146 147Destructor. Frees the associated memory depending on the field type. 148 149\membersection{wxQueryField::AllocData} 150 151\func{bool}{AllocData}{\void} 152 153Allocates memory depending on the size and type of the field. 154 155\membersection{wxQueryField::ClearData} 156 157\func{void}{ClearData}{\void} 158 159Deletes the contents of the field buffer without deallocating the memory. 160 161\membersection{wxQueryField::GetData} 162 163\func{void *}{GetData}{\void} 164 165Returns a pointer to the field buffer. 166 167\membersection{wxQueryField::GetSize} 168 169\func{long}{GetSize}{\void} 170 171Returns the size of the field buffer. 172 173\membersection{wxQueryField::GetType} 174 175\func{short}{GetType}{\void} 176 177Returns the type of the field (currently SQL\_CHAR, SQL\_VARCHAR or SQL\_INTEGER). 178 179\membersection{wxQueryField::IsDirty} 180 181\func{bool}{IsDirty}{\void} 182 183Returns true if the data of a field has been changed, but not saved. 184 185\membersection{wxQueryField::SetData} 186 187\func{bool}{SetData}{\param{void *}{data}, \param{long}{ sz}} 188 189Allocates memory of the size {\it sz} and copies the contents of {\it d} into the 190field buffer. 191 192\membersection{wxQueryField::SetDirty} 193 194\func{void}{SetDirty}{\param{bool}{ dirty = true}} 195 196Sets the dirty tag of a field. 197 198\membersection{wxQueryField::SetSize} 199 200\func{void}{SetSize}{\param{long}{ size}} 201 202Resizes the field buffer. Stored data will be lost. 203 204\membersection{wxQueryField::SetType} 205 206\func{void}{SetType}{\param{short }{type}} 207 208Sets the type of the field. Currently the types SQL\_CHAR, SQL\_VARCHAR and 209SQL\_INTEGER are supported. 210 211