e5eff43833
This should be the desired behaviour in the vast majority of cases, so do it by default. Replace the useless OnSearchButton() doing nothing with search button events with OnCancelButton() handling cancel button events and clearing the control. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@72581 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
279 lines
8.6 KiB
C++
279 lines
8.6 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/generic/srchctlg.h
|
|
// Purpose: generic wxSearchCtrl class
|
|
// Author: Vince Harron
|
|
// Created: 2006-02-19
|
|
// RCS-ID: $Id$
|
|
// Copyright: Vince Harron
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_GENERIC_SEARCHCTRL_H_
|
|
#define _WX_GENERIC_SEARCHCTRL_H_
|
|
|
|
#if wxUSE_SEARCHCTRL
|
|
|
|
#include "wx/bitmap.h"
|
|
|
|
class WXDLLIMPEXP_FWD_CORE wxSearchButton;
|
|
class WXDLLIMPEXP_FWD_CORE wxSearchTextCtrl;
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxSearchCtrl is a combination of wxTextCtrl and wxSearchButton
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_CORE wxSearchCtrl : public wxSearchCtrlBase
|
|
{
|
|
public:
|
|
// creation
|
|
// --------
|
|
|
|
wxSearchCtrl();
|
|
wxSearchCtrl(wxWindow *parent, wxWindowID id,
|
|
const wxString& value = wxEmptyString,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxValidator& validator = wxDefaultValidator,
|
|
const wxString& name = wxSearchCtrlNameStr);
|
|
|
|
virtual ~wxSearchCtrl();
|
|
|
|
bool Create(wxWindow *parent, wxWindowID id,
|
|
const wxString& value = wxEmptyString,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxValidator& validator = wxDefaultValidator,
|
|
const wxString& name = wxSearchCtrlNameStr);
|
|
|
|
#if wxUSE_MENUS
|
|
// get/set search button menu
|
|
// --------------------------
|
|
virtual void SetMenu( wxMenu* menu );
|
|
virtual wxMenu* GetMenu();
|
|
#endif // wxUSE_MENUS
|
|
|
|
// get/set search options
|
|
// ----------------------
|
|
virtual void ShowSearchButton( bool show );
|
|
virtual bool IsSearchButtonVisible() const;
|
|
|
|
virtual void ShowCancelButton( bool show );
|
|
virtual bool IsCancelButtonVisible() const;
|
|
|
|
// TODO: In 2.9 these should probably be virtual, and declared in the base class...
|
|
void SetDescriptiveText(const wxString& text);
|
|
wxString GetDescriptiveText() const;
|
|
|
|
// accessors
|
|
// ---------
|
|
|
|
virtual wxString GetRange(long from, long to) const;
|
|
|
|
virtual int GetLineLength(long lineNo) const;
|
|
virtual wxString GetLineText(long lineNo) const;
|
|
virtual int GetNumberOfLines() const;
|
|
|
|
virtual bool IsModified() const;
|
|
virtual bool IsEditable() const;
|
|
|
|
// more readable flag testing methods
|
|
virtual bool IsSingleLine() const;
|
|
virtual bool IsMultiLine() const;
|
|
|
|
// If the return values from and to are the same, there is no selection.
|
|
virtual void GetSelection(long* from, long* to) const;
|
|
|
|
virtual wxString GetStringSelection() const;
|
|
|
|
// operations
|
|
// ----------
|
|
|
|
// editing
|
|
virtual void Clear();
|
|
virtual void Replace(long from, long to, const wxString& value);
|
|
virtual void Remove(long from, long to);
|
|
|
|
// load/save the controls contents from/to the file
|
|
virtual bool LoadFile(const wxString& file);
|
|
virtual bool SaveFile(const wxString& file = wxEmptyString);
|
|
|
|
// sets/clears the dirty flag
|
|
virtual void MarkDirty();
|
|
virtual void DiscardEdits();
|
|
|
|
// set the max number of characters which may be entered in a single line
|
|
// text control
|
|
virtual void SetMaxLength(unsigned long WXUNUSED(len));
|
|
|
|
// writing text inserts it at the current position, appending always
|
|
// inserts it at the end
|
|
virtual void WriteText(const wxString& text);
|
|
virtual void AppendText(const wxString& text);
|
|
|
|
// insert the character which would have resulted from this key event,
|
|
// return true if anything has been inserted
|
|
virtual bool EmulateKeyPress(const wxKeyEvent& event);
|
|
|
|
// text control under some platforms supports the text styles: these
|
|
// methods allow to apply the given text style to the given selection or to
|
|
// set/get the style which will be used for all appended text
|
|
virtual bool SetStyle(long start, long end, const wxTextAttr& style);
|
|
virtual bool GetStyle(long position, wxTextAttr& style);
|
|
virtual bool SetDefaultStyle(const wxTextAttr& style);
|
|
virtual const wxTextAttr& GetDefaultStyle() const;
|
|
|
|
// translate between the position (which is just an index in the text ctrl
|
|
// considering all its contents as a single strings) and (x, y) coordinates
|
|
// which represent column and line.
|
|
virtual long XYToPosition(long x, long y) const;
|
|
virtual bool PositionToXY(long pos, long *x, long *y) const;
|
|
|
|
virtual void ShowPosition(long pos);
|
|
|
|
// find the character at position given in pixels
|
|
//
|
|
// NB: pt is in device coords (not adjusted for the client area origin nor
|
|
// scrolling)
|
|
virtual wxTextCtrlHitTestResult HitTest(const wxPoint& pt, long *pos) const;
|
|
virtual wxTextCtrlHitTestResult HitTest(const wxPoint& pt,
|
|
wxTextCoord *col,
|
|
wxTextCoord *row) const;
|
|
|
|
// Clipboard operations
|
|
virtual void Copy();
|
|
virtual void Cut();
|
|
virtual void Paste();
|
|
|
|
virtual bool CanCopy() const;
|
|
virtual bool CanCut() const;
|
|
virtual bool CanPaste() const;
|
|
|
|
// Undo/redo
|
|
virtual void Undo();
|
|
virtual void Redo();
|
|
|
|
virtual bool CanUndo() const;
|
|
virtual bool CanRedo() const;
|
|
|
|
// Insertion point
|
|
virtual void SetInsertionPoint(long pos);
|
|
virtual void SetInsertionPointEnd();
|
|
virtual long GetInsertionPoint() const;
|
|
virtual wxTextPos GetLastPosition() const;
|
|
|
|
virtual void SetSelection(long from, long to);
|
|
virtual void SelectAll();
|
|
virtual void SetEditable(bool editable);
|
|
|
|
#if 0
|
|
|
|
// override streambuf method
|
|
#if wxHAS_TEXT_WINDOW_STREAM
|
|
int overflow(int i);
|
|
#endif // wxHAS_TEXT_WINDOW_STREAM
|
|
|
|
// stream-like insertion operators: these are always available, whether we
|
|
// were, or not, compiled with streambuf support
|
|
wxTextCtrl& operator<<(const wxString& s);
|
|
wxTextCtrl& operator<<(int i);
|
|
wxTextCtrl& operator<<(long i);
|
|
wxTextCtrl& operator<<(float f);
|
|
wxTextCtrl& operator<<(double d);
|
|
wxTextCtrl& operator<<(const wxChar c);
|
|
#endif
|
|
|
|
// do the window-specific processing after processing the update event
|
|
virtual void DoUpdateWindowUI(wxUpdateUIEvent& event);
|
|
|
|
virtual bool ShouldInheritColours() const;
|
|
|
|
// wxWindow overrides
|
|
virtual bool SetFont(const wxFont& font);
|
|
virtual bool SetBackgroundColour(const wxColour& colour);
|
|
|
|
// search control generic only
|
|
void SetSearchBitmap( const wxBitmap& bitmap );
|
|
void SetCancelBitmap( const wxBitmap& bitmap );
|
|
#if wxUSE_MENUS
|
|
void SetSearchMenuBitmap( const wxBitmap& bitmap );
|
|
#endif // wxUSE_MENUS
|
|
|
|
protected:
|
|
virtual void DoSetValue(const wxString& value, int flags);
|
|
virtual wxString DoGetValue() const;
|
|
|
|
virtual bool DoLoadFile(const wxString& file, int fileType);
|
|
virtual bool DoSaveFile(const wxString& file, int fileType);
|
|
|
|
// override the base class virtuals involved into geometry calculations
|
|
virtual wxSize DoGetBestSize() const;
|
|
virtual void DoMoveWindow(int x, int y, int width, int height);
|
|
virtual void LayoutControls(int x, int y, int width, int height);
|
|
|
|
virtual void RecalcBitmaps();
|
|
|
|
void Init();
|
|
|
|
virtual wxBitmap RenderSearchBitmap( int x, int y, bool renderDrop );
|
|
virtual wxBitmap RenderCancelBitmap( int x, int y );
|
|
|
|
void OnCancelButton( wxCommandEvent& event );
|
|
|
|
void OnSetFocus( wxFocusEvent& event );
|
|
void OnSize( wxSizeEvent& event );
|
|
|
|
bool HasMenu() const
|
|
{
|
|
#if wxUSE_MENUS
|
|
return m_menu != NULL;
|
|
#else // !wxUSE_MENUS
|
|
return false;
|
|
#endif // wxUSE_MENUS/!wxUSE_MENUS
|
|
}
|
|
|
|
private:
|
|
friend class wxSearchButton;
|
|
|
|
// Implement pure virtual function inherited from wxCompositeWindow.
|
|
virtual wxWindowList GetCompositeWindowParts() const;
|
|
|
|
#if wxUSE_MENUS
|
|
void PopupSearchMenu();
|
|
#endif // wxUSE_MENUS
|
|
|
|
// the subcontrols
|
|
wxSearchTextCtrl *m_text;
|
|
wxSearchButton *m_searchButton;
|
|
wxSearchButton *m_cancelButton;
|
|
#if wxUSE_MENUS
|
|
wxMenu *m_menu;
|
|
#endif // wxUSE_MENUS
|
|
|
|
bool m_searchButtonVisible;
|
|
bool m_cancelButtonVisible;
|
|
|
|
bool m_searchBitmapUser;
|
|
bool m_cancelBitmapUser;
|
|
#if wxUSE_MENUS
|
|
bool m_searchMenuBitmapUser;
|
|
#endif // wxUSE_MENUS
|
|
|
|
wxBitmap m_searchBitmap;
|
|
wxBitmap m_cancelBitmap;
|
|
#if wxUSE_MENUS
|
|
wxBitmap m_searchMenuBitmap;
|
|
#endif // wxUSE_MENUS
|
|
|
|
private:
|
|
DECLARE_DYNAMIC_CLASS(wxSearchCtrl)
|
|
|
|
DECLARE_EVENT_TABLE()
|
|
};
|
|
|
|
#endif // wxUSE_SEARCHCTRL
|
|
|
|
#endif // _WX_GENERIC_SEARCHCTRL_H_
|
|
|