/************************************************************************* * * $RCSfile: cuifmsearch.hxx,v $ * * $Revision: 1.2 $ * * last change: $Author: hr $ $Date: 2004-02-03 18:21:13 $ * * The Contents of this file are made available subject to the terms of * either of the following licenses * * - GNU Lesser General Public License Version 2.1 * - Sun Industry Standards Source License Version 1.1 * * Sun Microsystems Inc., October, 2000 * * GNU Lesser General Public License Version 2.1 * ============================================= * Copyright 2000 by Sun Microsystems, Inc. * 901 San Antonio Road, Palo Alto, CA 94303, USA * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License version 2.1, as published by the Free Software Foundation. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, * MA 02111-1307 USA * * * Sun Industry Standards Source License Version 1.1 * ================================================= * The contents of this file are subject to the Sun Industry Standards * Source License Version 1.1 (the "License"); You may not use this file * except in compliance with the License. You may obtain a copy of the * License at http://www.openoffice.org/license.html. * * Software provided under this License is provided on an "AS IS" basis, * WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, * WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS, * MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING. * See the License for the specific provisions governing your rights and * obligations concerning the Software. * * The Initial Developer of the Original Code is: Sun Microsystems, Inc. * * Copyright: 2000 by Sun Microsystems, Inc. * * All Rights Reserved. * * Contributor(s): _______________________________________ * * ************************************************************************/ #ifndef _CUI_FMSEARCH_HXX #define _CUI_FMSEARCH_HXX #ifndef _COM_SUN_STAR_SDBC_XRESULTSET_HPP_ #include #endif #include "fmsearch.hxx" //CHINA001 #define _SVSTDARR_STRINGSDTOR #include #ifndef _DIALOG_HXX //autogen #include #endif #ifndef _BUTTON_HXX //autogen #include #endif #ifndef _FIXED_HXX //autogen #include #endif #ifndef _EDIT_HXX //autogen #include #endif #ifndef _SV_COMBOBOX_HXX //autogen #include #endif #ifndef _SV_LSTBOX_HXX //autogen #include #endif #ifndef _LINK_HXX //autogen #include #endif #ifndef _SFXCFGITEM_HXX //autogen #include #endif #ifndef _COMPHELPER_UNO3_HXX_ #include #endif #ifndef _COMPHELPER_STLTYPES_HXX_ #include #endif #ifndef _STRING_HXX #include #endif // =================================================================================================== // = class FmSearchDialog - Dialog fuer Suchen in Formularen/Tabellen // =================================================================================================== class FmSearchDialog : public ModalDialog { friend class FmSearchEngine; // meine ganzen Controls FixedLine m_flSearchFor; RadioButton m_rbSearchForText; RadioButton m_rbSearchForNull; RadioButton m_rbSearchForNotNull; ComboBox m_cmbSearchText; FixedLine m_flWhere; FixedText m_ftForm; ListBox m_lbForm; RadioButton m_rbAllFields; RadioButton m_rbSingleField; ListBox m_lbField; FixedLine m_flOptions; FixedText m_ftPosition; ListBox m_lbPosition; CheckBox m_cbUseFormat; CheckBox m_cbCase; CheckBox m_cbBackwards; CheckBox m_cbStartOver; CheckBox m_cbWildCard; CheckBox m_cbRegular; CheckBox m_cbApprox; PushButton m_pbApproxSettings; CheckBox m_aHalfFullFormsCJK; CheckBox m_aSoundsLikeCJK; PushButton m_aSoundsLikeCJKSettings; FixedLine m_flState; FixedText m_ftRecordLabel; FixedText m_ftRecord; FixedText m_ftHint; PushButton m_pbSearchAgain; CancelButton m_pbClose; HelpButton m_pbHelp; Window* m_pPreSearchFocus; Link m_lnkFoundHandler; // Handler fuer "gefunden" Link m_lnkCanceledNotFoundHdl; // Handler fuer Positionierung des Cursors Link m_lnkContextSupplier; // fuer Suche in verschiedenen Kontexten // ein Array, in dem ich mir fuer jeden Kontext das aktuell selektierte Feld merke ::std::vector m_arrContextFields; // fuer die eigentliche Arbeit ... FmSearchEngine* m_pSearchEngine; Timer m_aDelayedPaint; // siehe EnableSearchUI ::svxform::FmSearchConfigItem* m_pConfig; public: /** die drei moeglichen Such-Modi : SM_BRUTE sucht einfach nur ... da wird das Office in der Zeit wohl stehen SM_ALLOWSCHEDULE ruft nach jedem durchsuchten Feld ein Application::Reschedule auf, so dass die Suche zwar im aufrufenden Thread laeuft, aber die Office-UI wenigstens noch funktionieren sollte. Soweit das den Dialog angeht, achtet der selber darauf, dass keine Inkonsistenzen entstehen, was dabei ausserhalb des Dialoges liegt, muss natuerlich vom Aufrufer erledigt werden (Was nicht allzu kompliziert sein duerfte, da der Dialog hier ja modal sein sollte) SM_USETHREAD startet einen eigenen Thread, der die Suche erledigt, so dass also die UI auch hier weiterhin funktioniert. */ //CHINA001 enum SEARCH_MODE { SM_BRUTE, SM_ALLOWSCHEDULE, SM_USETHREAD }; /** Constructor 1: gesucht wird mittels des uebergebenen Iterators, wenn man also seinen Original-Cursor nicht bewegen will, muss man hier einen Clone uebergeben strVisibleFields muss eine (durch ; getrennte) Liste aller Felder, die zur Auswahl stehen sollen, enthalten xFormatter wird benutzt, wenn die Daten aus den Feldern vor dem Vergleich entsprechend ihrem FormatKey formatiert werden sollen Zu eMode siehe SEARCH_MODE. */ FmSearchDialog(Window* pParent, const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XResultSet>& xCursor, const String& strVisibleFields, const String& strInitialText, const ::com::sun::star::uno::Reference< ::com::sun::star::util::XNumberFormatsSupplier>& xFormatSupplier, FMSEARCH_MODE eMode = SM_ALLOWSCHEDULE); /** Constructor 2: hiermit kann in verschiedenen Saetzen von Feldern gesucht werden. Es gibt eine Reihe von Kontexten, deren Namen in strContexts stehen (getrennt durch ';'), der Benutzer kann einen davon auswaehlen. Wenn der Benutzer einen Kontext auswaehlt, wird lnkContextSupplier aufgerufen, er bekommt einen Zeiger auf eine FmSearchContext-Struktur, die gefuellt werden muss. Fuer die Suche gilt dann : a) bei formatierter Suche wird der Iterator selber verwendet (wie beim ersten Constructor auch) b) bei formatierter Suche wird NICHT der FormatKey an den Fields des Iterators verwendet, sondern die entsprechende TextComponent wird gefragt (deshalb auch die Verwendung des originalen Iterator, durch dessen Move werden hoffentlich die hinter den TextComponent-Interfaces stehenden Controls geupdatet) c) bei nicht formatierter Suche wird ein Clone des Iterators verwendet (da ich hier die TextComponent-Interfaces nicht fragen muss) (natuerlich zwingend erforderlich : der String Nummer i in strUsedFields eines Kontexts muss mit dem Interface Nummer i in arrFields des Kontexts korrespondieren) */ FmSearchDialog(Window* pParent, const String& strInitialText, const String& strContexts, sal_Int16 nInitialContext, const Link& lnkContextSupplier, FMSEARCH_MODE eMode = SM_ALLOWSCHEDULE); virtual ~FmSearchDialog(); /** der Found-Handler bekommt im "gefunden"-Fall einen Zeiger auf eine FmFoundRecordInformation-Struktur (dieser ist nur im Handler gueltig, wenn man sich also die Daten merken muss, nicht den Zeiger, sondern die Struktur kopieren) Dieser Handler MUSS gesetzt werden. Ausserdem sollte beachtet werden, dass waehrend des Handlers der Suchdialog immer noch modal ist */ void SetFoundHandler(const Link& lnk) { m_lnkFoundHandler = lnk; } /** Wenn die Suche abgebrochen oder erfolglos beendet wurde, wird im Suchdialog immer der aktuelle Datensatz angezeigt Damit das mit der eventuellen Anzeige des Aufrufers synchron geht, existiert dieser Handler (der nicht undbedingt gesetzt werden muss). Der dem Handler uebergebene Zeiger zeigt auf eine FmFoundRecordInformation-Struktur, bei der aPosition und eventuell (bei Suche mit Kontexten) nContext gueltig sind. */ void SetCanceledNotFoundHdl(const Link& lnk) { m_lnkCanceledNotFoundHdl = lnk; } inline void SetActiveField(const String& strField); protected: virtual sal_Bool Close(); void Init(const String& strVisibleFields, const String& strInitialText); // nur von den Constructoren aus zu verwenden void OnFound(const ::com::sun::star::uno::Any& aCursorPos, sal_Int16 nFieldPos); void EnableSearchUI(sal_Bool bEnable); // beim Suchen in einem eigenen Thread moechte ich natuerlich die UI zum Starten/Parameter-Setzen der Suche disablen // Bei bEnable == sal_False wird fuer alle betroffenen Controls das Painten kurz aus- und mittels m_aDelayedPaint nach // einer kurzen Weile wieder angeschaltet. Wenn inzwischen eine Anforderung mit bEnable==sal_True kommt, wird der Timer gestoppt // und das Painten gleich wieder angeschaltet. Als Konsequenz dieses umstaendlichen Vorgehens ist kein Flackern zu sehen, // wenn man schnell hintereinander aus- und wieder einschaltet. void EnableSearchForDependees(sal_Bool bEnable); void EnableControlPaint(sal_Bool bEnable); // enabled (disabled) fuer alle wichtigen Controls ihr Paint void InitContext(sal_Int16 nContext); void LoadParams(); void SaveParams() const; private: // Handler fuer die Controls DECL_LINK( OnClickedFieldRadios, Button* ); DECL_LINK( OnClickedSearchAgain, Button* ); DECL_LINK( OnClickedSpecialSettings, Button* ); DECL_LINK( OnSearchTextModified, ComboBox* ); DECL_LINK( OnPositionSelected, ListBox* ); DECL_LINK( OnFieldSelected, ListBox* ); DECL_LINK( OnCheckBoxToggled, CheckBox* ); DECL_LINK( OnContextSelection, ListBox* ); // um sich den Fokus nach einem Found wiederzuholen ... (wenn der Found-Handler das entsprechende Flag zurueckgibt) DECL_LINK( AsyncGrabFocus, void* ); // Such-Fortschritt DECL_LINK( OnSearchProgress, FmSearchProgress* ); DECL_LINK( OnDelayedPaint, void* ); // siehe EnableSearchUI void implMoveControls(Control** _ppControls, sal_Int32 _nControls, sal_Int32 _nUp, Control* _pToResize); void initCommon( const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XResultSet >& _rxCursor ); }; inline void FmSearchDialog::SetActiveField(const String& strField) { sal_uInt16 nInitialField = m_lbField.GetEntryPos(strField); if (nInitialField == COMBOBOX_ENTRY_NOTFOUND) nInitialField = 0; m_lbField.SelectEntryPos(nInitialField); LINK(this, FmSearchDialog, OnFieldSelected).Call(&m_lbField); } #endif // _CUI_FMSEARCH_HXX