Skip to content

Commit

Permalink
Documentation for Find Dialog and a few bug fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
rparkins999 committed Jan 8, 2017
1 parent 5b68e2d commit 38cddc4
Show file tree
Hide file tree
Showing 27 changed files with 1,475 additions and 747 deletions.
3 changes: 3 additions & 0 deletions Sqliteman/sqliteman/dataviewer.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -190,13 +190,15 @@ void DataViewer::findNext(int row)
ui.itemView->setCurrentIndex(row, column);
}
updateButtons();
ui.statusText->hide();
QApplication::restoreOverrideCursor();
return;
}
}
QApplication::restoreOverrideCursor();
}
ui.statusText->setPlainText("Not found");
ui.statusText->show();
}

void DataViewer::removeFinder()
Expand Down Expand Up @@ -267,6 +269,7 @@ void DataViewer::findAll()
if (!anyFound)
{
ui.statusText->setPlainText("No match found");
ui.statusText->show();
unFindAll();
}
else
Expand Down
3 changes: 3 additions & 0 deletions Sqliteman/sqliteman/doc/doc.qrc
Original file line number Diff line number Diff line change
Expand Up @@ -56,9 +56,12 @@
<file>en/ch07s11.html</file>
<file>en/ch07s12.html</file>
<file>en/ch07s13.html</file>
<file>en/ch07s14.html</file>
<file>en/ch07s15.html</file>
<file>en/ch08.html</file>
<file>en/ch09.html</file>
<file>en/ch09s02.html</file>
<file>en/finddialog.png</file>
<file>en/index.html</file>
<file>en/index.png</file>
<file>en/insert_table_row.png</file>
Expand Down
2 changes: 1 addition & 1 deletion Sqliteman/sqliteman/doc/en/ch04.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@
</p><div class="screenshot"><div class="mediaobject"><img src="mainwindow.png" alt="Screenshot of the Main Window"></div></div><p>
</p><p>All interface elements contains so called "tool tips" – quick
notes which are available when you stay with a mouse cursor in the element
are for a while.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Start the Application </td><td width="20%" align="center"><a accesskey="h" href="index.html">Contents</a></td><td width="40%" align="right" valign="top"> Chapter 5. <span class="application">Sqliteman</span> Main Window</td></tr></table></div></body></html>
are for a while.</p><p>All sqliteman windows remember their dimensions between invocations of sqliteman. If you change the size of a window, it will always reappear with the last size that you set it to.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Start the Application </td><td width="20%" align="center"><a accesskey="h" href="index.html">Contents</a></td><td width="40%" align="right" valign="top"> Chapter 5. <span class="application">Sqliteman</span> Main Window</td></tr></table></div></body></html>
2 changes: 1 addition & 1 deletion Sqliteman/sqliteman/doc/en/ch05.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
<a href="ch07s12.html" title="SQL Editor">See SQL Editor documentation</a>.
</p></dd><dt><span class="term">Result Table</span></dt><dd><p>
All queries results and related stuff is shown here.
<a href="ch07s13.html" title="Data Viewer">See Data Browser documentation</a>.
<a href="ch07s14.html" title="Data Viewer">See Data Browser documentation</a>.
</p></dd><dt><span class="term">Error Log</span></dt><dd><p>
Error messages and status is written here. This window resizes itself to fit its content, and will not be visible at all if there is no status or error to show.
</p></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch04.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch06.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 4. The First Overview </td><td width="20%" align="center"><a accesskey="h" href="index.html">Contents</a></td><td width="40%" align="right" valign="top"> Chapter 6. <span class="application">Sqliteman</span> Menu Structure</td></tr></table></div></body></html>
11 changes: 6 additions & 5 deletions Sqliteman/sqliteman/doc/en/ch07.html
Original file line number Diff line number Diff line change
@@ -1,16 +1,17 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 7. Features and Dialogs</title><link rel="stylesheet" href="kde-default.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.67.2"><meta name="keywords" content="Sqliteman, SQL, Sqlite, development, database"><link rel="start" href="index.html" title="The Sqliteman Handbook"><link rel="up" href="index.html" title="The Sqliteman Handbook"><link rel="prev" href="ch06s05.html" title="The Help Menu"><link rel="next" href="ch07s00.html" title="User defined functions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 7. Features and Dialogs</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch06s05.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch07s00.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2525350"></a>Chapter 7. Features and Dialogs</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="ch07.html#preferences">Preferences</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch07.html#id2525375">Look and Feel</a></span></dt><dt><span class="sect2"><a href="ch07.html#preferences-dataViewer">Data Display</a></span></dt><dt><span class="sect2"><a href="ch07.html#preferences-sqlEditor">SQL Editor</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch07s00.html">User defined functions</a></span></dt><dt><span class="sect1"><a href="ch07s01.html">Auto Commit and Transaction Pending modes</a></span></dt><dt><span class="sect1"><a href="ch07s02.html">Create Table</a></span></dt><dt><span class="sect1"><a href="ch07s03.html">Alter Table</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch07s03.html#id2526118">Steps to alter table</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch07s04.html">Import Table Data</a></span></dt><dt><span class="sect1"><a href="ch07s05.html">Populate Table</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch07s05.html#id2526493">Column Settings</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch07s06.html">Create View</a></span></dt><dt><span class="sect1"><a href="ch07s07.html">Create Index</a></span></dt><dt><span class="sect1"><a href="ch07s08.html">Constraint Triggers</a></span></dt><dt><span class="sect1"><a href="ch07s09.html">Attached Databases</a></span></dt><dt><span class="sect1"><a href="ch07s10.html">Schema Browser</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch07s10.html#pragmaEditor">Pragma Editor</a></span></dt></dl></dd>
<dt><span class="sect1"><a href="ch07s11.html">Query Builder</a></span></dt>
<dt><span class="sect1"><a href="ch07s12.html">SQL Editor</a></span></dt>
<dt><span class="sect1"><a href="ch07s13.html">Data Viewer</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch07s13.html#id2527777">Display Types</a></span></dt><dt><span class="sect2"><a href="ch07s13.html#dataViewer-editor">Data Editor</a></span></dt><dt><span class="sect2"><a href="ch07s13.html#advanced">Multiline Editor</a></span></dt><dt><span class="sect2"><a href="ch07s13.html#dataViewer-fetching">Fetching the data</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch07s14.html">Export Data</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch07s13.html#id2528452">Supported Formats</a></span></dt></dl></dd></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="preferences"></a>Preferences</h2></div></div></div><p>Preferences dialog allows you to customize <span class="application">Sqliteman</span> to fit your needs better.</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2525375"></a>Look and Feel</h3></div></div></div><p>You can set GUI behavior in in this section. Remember that Language and Style settings require <span class="application">Sqliteman</span> restart to take effect. Some of these preferences can be overridden by the application
<dt><span class="sect1"><a href="ch07s13.html">Find Dialog</a></span></dt>
<dt><span class="sect1"><a href="ch07s14.html">Data Viewer</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch07s14.html#id2527777">Display Types</a></span></dt><dt><span class="sect2"><a href="ch07s14.html#dataViewer-editor">Data Editor</a></span></dt><dt><span class="sect2"><a href="ch07s14.html#advanced">Multiline Editor</a></span></dt><dt><span class="sect2"><a href="ch07s14.html#dataViewer-fetching">Fetching the data</a></span></dt></dl></dd><dt><span class="sect1"><a href="ch07s15.html">Export Data</a></span></dt><dd><dl><dt><span class="sect2"><a href="ch07s14.html#id2528452">Supported Formats</a></span></dt></dl></dd></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="preferences"></a>Preferences</h2></div></div></div><p>Preferences dialog allows you to customize <span class="application">Sqliteman</span> to fit your needs better.</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2525375"></a>Look and Feel</h3></div></div></div><p>You can set GUI behavior in in this section. Remember that Language and Style settings require <span class="application">Sqliteman</span> restart to take effect. Some of these preferences can be overridden by the application
<a href="ch03.html#options" title="options">command line parameters</a>.</p><p>
</p><div class="screenshot"><div class="mediaobject"><img src="preferences-lnf.png" alt="Preferences: Look and Feel"></div></div><p>
</p><div class="variablelist"><dl><dt><span class="term">GUI Language</span></dt><dd><p>Allow to choose one of the translations for user interface.
</p><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Caution</h3><p>Remember that translations are provide by group of volunteers (not by <span class="application">Sqliteman</span> developers). It's better <a href="ch09.html" title="Chapter 9. Credits and License">to contact translation authors</a> in the case of bug.</p></div></dd><dt><span class="term">GUI Style</span></dt><dd><p>Change the application "skin". Available styles are depending on platform. Default style should be good choice.</p></dd><dt><span class="term">GUI Font</span></dt><dd><p>Change the font and/or size used for GUI text.</p></dd><dt><span class="term">Recently Used Databases</span></dt><dd><p>Specify the count of items in the <span class="guimenu">File</span>-&gt;<span class="guimenuitem">Recent Databases</span> menu.</p></dd><dt><span class="term">Open Last Database on Start</span></dt><dd><p>When it's checked, the last used database will be opened on the next <span class="application">Sqliteman</span> start.</p></dd><dt><span class="term">Open Last SQL Document on Start</span></dt><dd><p>When it's checked, the last used SQL script will be opened on the next <span class="application">Sqliteman</span> start.</p></dd><dt><span class="term">Rows to read from tables:</span></dt><dd><p>This determines the number of rows initially read from a table when opening it. Available choices are 256, 512, 1024, 2048, 4096, or All.</p></dd><dt><span class="term">Open New Row in Item View </span></dt><dd><p>When it's checked, clicking the
<a href="ch07s13.html#newrow">New Row</a> or
<a href="ch07s13.html#copyrow">Duplicate Row</a>
<a href="ch07s14.html#newrow">New Row</a> or
<a href="ch07s14.html#copyrow">Duplicate Row</a>
button will cause the newly created row to be opened in the
<a href="ch07s13.html#itemview">Item View.</a></p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="preferences-dataViewer"></a>Data Display</h3></div></div></div><p>Change settings of the data result viewer here. There is no application restart required here.
Viewer features are <a href="ch07s13.html" title="Data Viewer">described in its own section</a>.</p><p>
<a href="ch07s14.html#itemview">Item View.</a></p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="preferences-dataViewer"></a>Data Display</h3></div></div></div><p>Change settings of the data result viewer here. There is no application restart required here.
Viewer features are <a href="ch07s14.html" title="Data Viewer">described in its own section</a>.</p><p>
</p><div class="screenshot"><div class="mediaobject"><img src="preferences-display.png" alt="Preferences: Data Display"></div></div><p>
</p><div class="variablelist"><dl><dt><span class="term">NULL handling</span></dt><dd><p>There is no difference in displaying NULL value and an empty string if is this option disabled.</p><p>If you enable this feature, you can set the background color and the substitution
string to highlight real NULL value. The empty string display is unchanged.</p></dd><dt><span class="term">BLOB handling</span></dt><dd><p>If is this option disabled, you will get unfiltered binary content of
Expand Down
16 changes: 16 additions & 0 deletions Sqliteman/sqliteman/doc/en/ch07s00.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>User defined functions</title><link rel="stylesheet" href="kde-default.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.67.2"><meta name="keywords" content="Sqliteman, SQL, Sqlite, development, database"><link rel="start" href="index.html" title="The Sqliteman Handbook"><link rel="up" href="ch07.html" title="Chapter 7. Features and Dialogs"><link rel="prev" href="ch07.html" title="Chapter 7. Features and Dialogs"><link rel="next" href="ch07s01.html" title="User defined functions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">User defined functions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch07.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Features and Dialogs</th><td width="20%" align="right"> <a accesskey="n" href="ch07s01.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="User defined functions"></a>User defined functions</h2></div></div></div>
<p>Sqliteman provides the following user-defined function in addition to the built-in functions supported by sqlite:-</p>
<div class="variablelist">
<dl><dt><span class="term">exec (NAME, STATEMENT)</span></dt>
<dd>
<p>This function is called with two arguments which are both sql strings. NAME must be either NULL or a valid sql identifier which is not the name of an existing table or view. Otherwise the exec() function will fail with an appropriate error message. The exec() function can also fail if sqlite runs out of memory or encounters a similar fatal error.</p>
<ul>
<li>If NAME is NULL, exec() returns the first row of the first column of the table returned by executing STATEMENT as an sql statement. If executing STATEMENT fails or succeeds but does not generate a table, exec() returns NULL.</li>
<li>If NAME is a valid sql identifier which is not the name of an existing table or view, the exec() function creates table NAME containing the result of attempting to execute STATEMENT as an sql statement, and exec() itself returns a null. In this case if STATEMENT succeeds but does not generate a table, exec() does not create a table and returns NULL, and if STATEMENT fails exec() does not create a table and returns the error message caused by the failure. Normally EXPLAIN, most PRAGMAs, SELECT, and VALUES statements generate tables if they succeed.</li>
</ul>
<p>exec() can be used in scripts to execute dynamically generated statements, check for errors, and examine results of PRAGMAs. The form with a NULL first argument can be used to extract a value from a table without causing the script to fail if the table does not exist.</p>
<p>exec() is used by Sqliteman's internal tests. These are included in the source distribution and can be examined as examples for how to use it.</p>
</dd>
</dd></dl></div></div>
<p>Sqliteman also provides two additonal collators LOCALIZED and LOCALIZED_CASE. These sort in Locale order. LOCALIZED is like the LOCALIZED collator provided by the Android implementation of sqlite (which is not case-sensitive), while the LOCALIZED_CASE collator is case-sensitive. Care should be taken when using these collators. It is always safe to use them in queries inside sqliteman itself. However if an object (such as a view) is created in the database referencing LOCALIZED or LOCALIZED_CASE, it will not be possible to access that object with an sqlite implementation which does not support that collator.
<div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch07.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch07.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch07s01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 7. Features and Dialogs </td><td width="20%" align="center"><a accesskey="h" href="index.html">Contents</a></td><td width="40%" align="right" valign="top"> Auto commit and Transaction Pending modes</td></tr></table></div></body></html>
Loading

0 comments on commit 38cddc4

Please sign in to comment.