INTEGRATION: CWS qiq (1.3.118); FILE MERGED

2006/05/10 12:08:57 fs 1.3.118.1: #i51143# the tables supplier might also return queries now ....

1 files changed, 16 insertions, 2 deletions

diff --git a/offapi/com/sun/star/sdb/SingleSelectQueryAnalyzer.idl b/offapi/com/sun/star/sdb/SingleSelectQueryAnalyzer.idl
index fc6cd2b62021..a94ee48a21b9 100644
--- a/offapi/com/sun/star/sdb/SingleSelectQueryAnalyzer.idl
+++ b/offapi/com/sun/star/sdb/SingleSelectQueryAnalyzer.idl
@@ -4,9 +4,9 @@
  *
  *  $RCSfile: SingleSelectQueryAnalyzer.idl,v $
  *
- *  $Revision: 1.3 $
+ *  $Revision: 1.4 $
  *
- *  last change: $Author: rt $ $Date: 2005-09-08 03:24:41 $
+ *  last change: $Author: obo $ $Date: 2006-07-10 14:49:53 $
  *
  *  The Contents of this file are made available subject to
  *  the terms of GNU Lesser General Public License Version 2.1.
@@ -63,6 +63,20 @@ service SingleSelectQueryAnalyzer
     interface XSingleSelectQueryAnalyzer;
 
     /** access to the selected tables.
+
+        <p>The selected tables are those present in the <code>FROM</code> part
+        of a <code>SELECT</code> statement.</p>
+
+        <p>Note that OpenOffice.org since version 2.0.4 also supports queries which are
+        based on other queries. For example, given that you have a database containing
+        a query named <code>All Orders</code>, the SQL statement <code>SELECT * FROM "All Orders"</code>
+        is perfectly valid when used with a <type>SingleSelectQueryAnalyzer</type>.</p>
+
+        <p>In this case, the name container returned by <member scope="com::sun::star::sdbcx">XTablesSupplier::getTables</member>
+        will in fact not return a <type>Table</type>, but a <type>Query</type> object. Semantically, however,
+        this object still acts as a table in the SQL statement.</p>
+
+        @see XSingleSelectQueryAnalyzer::getQueryWithSubstitution
      */
     interface com::sun::star::sdbcx::XTablesSupplier;