1999-07-14 18:55:57 -04:00
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Name: textctrl.h
|
|
|
|
// Purpose: wxTextCtrlBase class - the interface of wxTextCtrl
|
|
|
|
// Author: Vadim Zeitlin
|
|
|
|
// Modified by:
|
|
|
|
// Created: 13.07.99
|
|
|
|
// RCS-ID: $Id$
|
|
|
|
// Copyright: (c) wxWindows team
|
|
|
|
// Licence: wxWindows licence
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
1998-08-14 20:23:28 -04:00
|
|
|
#ifndef _WX_TEXTCTRL_H_BASE_
|
|
|
|
#define _WX_TEXTCTRL_H_BASE_
|
1998-05-20 10:01:55 -04:00
|
|
|
|
1999-07-14 18:55:57 -04:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// headers
|
|
|
|
// ----------------------------------------------------------------------------
|
2001-05-26 23:28:28 -04:00
|
|
|
|
2002-08-31 07:29:13 -04:00
|
|
|
#if defined(__GNUG__) && !defined(__APPLE__)
|
1999-08-12 08:18:49 -04:00
|
|
|
#pragma interface "textctrlbase.h"
|
2001-05-26 23:28:28 -04:00
|
|
|
#endif
|
1999-07-14 18:55:57 -04:00
|
|
|
|
|
|
|
#include "wx/defs.h"
|
2001-06-26 16:59:19 -04:00
|
|
|
|
|
|
|
#if wxUSE_TEXTCTRL
|
|
|
|
|
1999-07-14 18:55:57 -04:00
|
|
|
#include "wx/control.h" // the base class
|
2003-06-20 12:25:31 -04:00
|
|
|
#include "wx/dynarray.h"
|
1999-07-14 18:55:57 -04:00
|
|
|
|
|
|
|
// 16-bit Borland 4.0 doesn't seem to allow multiple inheritance with wxWindow
|
|
|
|
// and streambuf: it complains about deriving a huge class from the huge class
|
|
|
|
// streambuf. !! Also, can't use streambuf if making or using a DLL :-(
|
|
|
|
|
2001-10-19 12:27:15 -04:00
|
|
|
#if (defined(__BORLANDC__)) || defined(__MWERKS__) || \
|
|
|
|
defined(WXUSINGDLL) || defined(WXMAKINGDLL)
|
2001-06-06 12:51:53 -04:00
|
|
|
#define NO_TEXT_WINDOW_STREAM
|
|
|
|
#endif
|
|
|
|
|
1999-07-14 18:55:57 -04:00
|
|
|
#ifndef NO_TEXT_WINDOW_STREAM
|
1999-07-15 13:30:33 -04:00
|
|
|
#if wxUSE_STD_IOSTREAM
|
2003-01-25 19:12:12 -05:00
|
|
|
#include "wx/ioswrap.h" // derivation: we need the full decls.
|
1999-07-14 18:55:57 -04:00
|
|
|
#else // !wxUSE_STD_IOSTREAM
|
|
|
|
// can't compile this feature in if we don't use streams at all
|
|
|
|
#define NO_TEXT_WINDOW_STREAM
|
|
|
|
#endif // wxUSE_STD_IOSTREAM/!wxUSE_STD_IOSTREAM
|
|
|
|
#endif
|
|
|
|
|
1999-07-15 09:42:27 -04:00
|
|
|
class WXDLLEXPORT wxTextCtrl;
|
2001-11-26 09:50:50 -05:00
|
|
|
class WXDLLEXPORT wxTextCtrlBase;
|
1999-07-15 09:42:27 -04:00
|
|
|
|
1999-07-14 18:55:57 -04:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// constants
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
WXDLLEXPORT_DATA(extern const wxChar*) wxTextCtrlNameStr;
|
|
|
|
|
2001-07-29 18:40:21 -04:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxTextCtrl style flags
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
Applied patch [ 603858 ] wxTextCtrl text alignment patch
Benjamin I. Williams
This patch implements three new flags for the
wxTextCtrl control. The flags are wxTE_LEFT,
wxTE_CENTRE, and wxTE_RIGHT. These flags can change
the way text is aligned inside an edit control, which
is useful when the user is editing numbers or dates.
At Vadim's recommendation, the patch implements the
alignment flags so they are equal to the corresponding
wxALIGN_* value. wxTE_LEFT is actually 0x0000, and is
just a place holder. wxTE_CENTRE is equal to
wx_ALIGN_CENTER_HORIZONTAL (0x0100), and wxTE_RIGHT is
equal to wxALIGN_RIGHT (0x0100). I couldn't agree more
with this idea.
As Vadim pointed out, choosing to set the text
alignment flags to the corresponding wxALIGN_* flags
has a slight negative side effect: the values 0x0100
and 0x0200 collide with the existing flags
wxTE_NO_VSCROLL and wxTE_AUTO_SCROLL. A valid point
was raised, however, which stated that the flags would
never really be used at the same time, and also that
wxTE_AUTO_SCROLL is (possibly) going to be deprecated
anyway.
While this collision is not really a problem, I didn't
like the idea of someone specifying wxTE_NO_VSCROLL and
ending up with with a centered text control ! Thus, I
chose to move both wxTE_NO_VSCROLL and wxTE_AUTO_SCROLL
down to the free bits 0x0002 and 0x0008, respectively.
I'll leave the final say up to Vadim and the rest of
you whether you want to move these flags down or keep
them where they are (with collisions). What truly
matters to me is that I can now create text controls
with the proper alignment!
This patch also updates the documentation.
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@16989 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2002-09-05 12:15:30 -04:00
|
|
|
// the flag bits 0x0001, and 0x0004 are free but should be used only for the
|
2001-07-29 18:40:21 -04:00
|
|
|
// things which don't make sense for a text control used by wxTextEntryDialog
|
|
|
|
// because they would otherwise conflict with wxOK, wxCANCEL, wxCENTRE
|
Applied patch [ 603858 ] wxTextCtrl text alignment patch
Benjamin I. Williams
This patch implements three new flags for the
wxTextCtrl control. The flags are wxTE_LEFT,
wxTE_CENTRE, and wxTE_RIGHT. These flags can change
the way text is aligned inside an edit control, which
is useful when the user is editing numbers or dates.
At Vadim's recommendation, the patch implements the
alignment flags so they are equal to the corresponding
wxALIGN_* value. wxTE_LEFT is actually 0x0000, and is
just a place holder. wxTE_CENTRE is equal to
wx_ALIGN_CENTER_HORIZONTAL (0x0100), and wxTE_RIGHT is
equal to wxALIGN_RIGHT (0x0100). I couldn't agree more
with this idea.
As Vadim pointed out, choosing to set the text
alignment flags to the corresponding wxALIGN_* flags
has a slight negative side effect: the values 0x0100
and 0x0200 collide with the existing flags
wxTE_NO_VSCROLL and wxTE_AUTO_SCROLL. A valid point
was raised, however, which stated that the flags would
never really be used at the same time, and also that
wxTE_AUTO_SCROLL is (possibly) going to be deprecated
anyway.
While this collision is not really a problem, I didn't
like the idea of someone specifying wxTE_NO_VSCROLL and
ending up with with a centered text control ! Thus, I
chose to move both wxTE_NO_VSCROLL and wxTE_AUTO_SCROLL
down to the free bits 0x0002 and 0x0008, respectively.
I'll leave the final say up to Vadim and the rest of
you whether you want to move these flags down or keep
them where they are (with collisions). What truly
matters to me is that I can now create text controls
with the proper alignment!
This patch also updates the documentation.
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@16989 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2002-09-05 12:15:30 -04:00
|
|
|
|
|
|
|
#define wxTE_NO_VSCROLL 0x0002
|
|
|
|
#define wxTE_AUTO_SCROLL 0x0008
|
|
|
|
|
2001-07-29 18:40:21 -04:00
|
|
|
#define wxTE_READONLY 0x0010
|
|
|
|
#define wxTE_MULTILINE 0x0020
|
|
|
|
#define wxTE_PROCESS_TAB 0x0040
|
|
|
|
|
Applied patch [ 603858 ] wxTextCtrl text alignment patch
Benjamin I. Williams
This patch implements three new flags for the
wxTextCtrl control. The flags are wxTE_LEFT,
wxTE_CENTRE, and wxTE_RIGHT. These flags can change
the way text is aligned inside an edit control, which
is useful when the user is editing numbers or dates.
At Vadim's recommendation, the patch implements the
alignment flags so they are equal to the corresponding
wxALIGN_* value. wxTE_LEFT is actually 0x0000, and is
just a place holder. wxTE_CENTRE is equal to
wx_ALIGN_CENTER_HORIZONTAL (0x0100), and wxTE_RIGHT is
equal to wxALIGN_RIGHT (0x0100). I couldn't agree more
with this idea.
As Vadim pointed out, choosing to set the text
alignment flags to the corresponding wxALIGN_* flags
has a slight negative side effect: the values 0x0100
and 0x0200 collide with the existing flags
wxTE_NO_VSCROLL and wxTE_AUTO_SCROLL. A valid point
was raised, however, which stated that the flags would
never really be used at the same time, and also that
wxTE_AUTO_SCROLL is (possibly) going to be deprecated
anyway.
While this collision is not really a problem, I didn't
like the idea of someone specifying wxTE_NO_VSCROLL and
ending up with with a centered text control ! Thus, I
chose to move both wxTE_NO_VSCROLL and wxTE_AUTO_SCROLL
down to the free bits 0x0002 and 0x0008, respectively.
I'll leave the final say up to Vadim and the rest of
you whether you want to move these flags down or keep
them where they are (with collisions). What truly
matters to me is that I can now create text controls
with the proper alignment!
This patch also updates the documentation.
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@16989 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2002-09-05 12:15:30 -04:00
|
|
|
// alignment flags
|
|
|
|
#define wxTE_LEFT 0x0000 // 0x0000
|
|
|
|
#define wxTE_CENTER wxALIGN_CENTER_HORIZONTAL // 0x0100
|
|
|
|
#define wxTE_RIGHT wxALIGN_RIGHT // 0x0200
|
|
|
|
#define wxTE_CENTRE wxTE_CENTER
|
|
|
|
|
2001-07-29 18:40:21 -04:00
|
|
|
// this style means to use RICHEDIT control and does something only under wxMSW
|
|
|
|
// and Win32 and is silently ignored under all other platforms
|
|
|
|
#define wxTE_RICH 0x0080
|
Applied patch [ 603858 ] wxTextCtrl text alignment patch
Benjamin I. Williams
This patch implements three new flags for the
wxTextCtrl control. The flags are wxTE_LEFT,
wxTE_CENTRE, and wxTE_RIGHT. These flags can change
the way text is aligned inside an edit control, which
is useful when the user is editing numbers or dates.
At Vadim's recommendation, the patch implements the
alignment flags so they are equal to the corresponding
wxALIGN_* value. wxTE_LEFT is actually 0x0000, and is
just a place holder. wxTE_CENTRE is equal to
wx_ALIGN_CENTER_HORIZONTAL (0x0100), and wxTE_RIGHT is
equal to wxALIGN_RIGHT (0x0100). I couldn't agree more
with this idea.
As Vadim pointed out, choosing to set the text
alignment flags to the corresponding wxALIGN_* flags
has a slight negative side effect: the values 0x0100
and 0x0200 collide with the existing flags
wxTE_NO_VSCROLL and wxTE_AUTO_SCROLL. A valid point
was raised, however, which stated that the flags would
never really be used at the same time, and also that
wxTE_AUTO_SCROLL is (possibly) going to be deprecated
anyway.
While this collision is not really a problem, I didn't
like the idea of someone specifying wxTE_NO_VSCROLL and
ending up with with a centered text control ! Thus, I
chose to move both wxTE_NO_VSCROLL and wxTE_AUTO_SCROLL
down to the free bits 0x0002 and 0x0008, respectively.
I'll leave the final say up to Vadim and the rest of
you whether you want to move these flags down or keep
them where they are (with collisions). What truly
matters to me is that I can now create text controls
with the proper alignment!
This patch also updates the documentation.
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@16989 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2002-09-05 12:15:30 -04:00
|
|
|
|
2001-07-29 18:40:21 -04:00
|
|
|
#define wxTE_PROCESS_ENTER 0x0400
|
|
|
|
#define wxTE_PASSWORD 0x0800
|
|
|
|
|
|
|
|
// automatically detect the URLs and generate the events when mouse is
|
|
|
|
// moved/clicked over an URL
|
|
|
|
//
|
|
|
|
// this is for Win32 richedit controls only so far
|
|
|
|
#define wxTE_AUTO_URL 0x1000
|
|
|
|
|
2001-10-17 20:53:35 -04:00
|
|
|
// by default, the Windows text control doesn't show the selection when it
|
|
|
|
// doesn't have focus - use this style to force it to always show it
|
|
|
|
#define wxTE_NOHIDESEL 0x2000
|
|
|
|
|
2001-11-25 13:11:47 -05:00
|
|
|
// use wxHSCROLL to not wrap text at all, wxTE_LINEWRAP to wrap it at any
|
|
|
|
// position and wxTE_WORDWRAP to wrap at words boundary
|
|
|
|
#define wxTE_DONTWRAP wxHSCROLL
|
|
|
|
#define wxTE_LINEWRAP 0x4000
|
|
|
|
#define wxTE_WORDWRAP 0x0000 // it's just == !wxHSCROLL
|
|
|
|
|
2002-01-08 20:32:02 -05:00
|
|
|
// force using RichEdit version 2.0 or 3.0 instead of 1.0 (default) for
|
|
|
|
// wxTE_RICH controls - can be used together with or instead of wxTE_RICH
|
|
|
|
#define wxTE_RICH2 0x8000
|
|
|
|
|
2003-06-20 12:25:31 -04:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// Types for wxTextAttr
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
// Alignment
|
|
|
|
|
|
|
|
enum wxTextAttrAlignment
|
|
|
|
{
|
|
|
|
wxTEXT_ALIGNMENT_DEFAULT,
|
|
|
|
wxTEXT_ALIGNMENT_LEFT,
|
|
|
|
wxTEXT_ALIGNMENT_CENTRE,
|
|
|
|
wxTEXT_ALIGNMENT_CENTER = wxTEXT_ALIGNMENT_CENTRE,
|
|
|
|
wxTEXT_ALIGNMENT_RIGHT,
|
|
|
|
wxTEXT_ALIGNMENT_JUSTIFIED
|
|
|
|
};
|
|
|
|
|
|
|
|
// Flags to indicate which attributes are being applied
|
|
|
|
|
|
|
|
#define wxTEXT_ATTR_TEXT_COLOUR 0x0001
|
|
|
|
#define wxTEXT_ATTR_BACKGROUND_COLOUR 0x0002
|
|
|
|
#define wxTEXT_ATTR_FONT_FACE 0x0004
|
|
|
|
#define wxTEXT_ATTR_FONT_SIZE 0x0008
|
|
|
|
#define wxTEXT_ATTR_FONT_WEIGHT 0x0010
|
|
|
|
#define wxTEXT_ATTR_FONT_ITALIC 0x0020
|
|
|
|
#define wxTEXT_ATTR_FONT_UNDERLINE 0x0040
|
|
|
|
#define wxTEXT_ATTR_FONT \
|
|
|
|
wxTEXT_ATTR_FONT_FACE | wxTEXT_ATTR_FONT_SIZE | wxTEXT_ATTR_FONT_WEIGHT | wxTEXT_ATTR_FONT_ITALIC | wxTEXT_ATTR_FONT_UNDERLINE
|
|
|
|
#define wxTEXT_ATTR_ALIGNMENT 0x0080
|
|
|
|
#define wxTEXT_ATTR_LEFT_INDENT 0x0100
|
|
|
|
#define wxTEXT_ATTR_RIGHT_INDENT 0x0200
|
|
|
|
#define wxTEXT_ATTR_TABS 0x0400
|
|
|
|
|
2001-05-26 23:28:28 -04:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxTextAttr: a structure containing the visual attributes of a text
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class WXDLLEXPORT wxTextAttr
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
// ctors
|
2003-06-20 12:25:31 -04:00
|
|
|
wxTextAttr() { Init(); }
|
2001-05-26 23:28:28 -04:00
|
|
|
wxTextAttr(const wxColour& colText,
|
|
|
|
const wxColour& colBack = wxNullColour,
|
2003-06-20 12:25:31 -04:00
|
|
|
const wxFont& font = wxNullFont,
|
|
|
|
wxTextAttrAlignment alignment = wxTEXT_ALIGNMENT_DEFAULT);
|
|
|
|
|
|
|
|
// operations
|
|
|
|
void Init();
|
|
|
|
|
|
|
|
// operators
|
|
|
|
void operator= (const wxTextAttr& attr);
|
2001-05-26 23:28:28 -04:00
|
|
|
|
|
|
|
// setters
|
2003-06-20 12:25:31 -04:00
|
|
|
void SetTextColour(const wxColour& colText) { m_colText = colText; m_flags |= wxTEXT_ATTR_TEXT_COLOUR; }
|
|
|
|
void SetBackgroundColour(const wxColour& colBack) { m_colBack = colBack; m_flags |= wxTEXT_ATTR_BACKGROUND_COLOUR; }
|
|
|
|
void SetFont(const wxFont& font, long flags = wxTEXT_ATTR_FONT) { m_font = font; m_flags |= flags; }
|
|
|
|
void SetAlignment(wxTextAttrAlignment alignment) { m_textAlignment = alignment; m_flags |= wxTEXT_ATTR_ALIGNMENT; }
|
|
|
|
void SetTabs(const wxArrayInt& tabs) { m_tabs = tabs; m_flags |= wxTEXT_ATTR_TABS; }
|
|
|
|
void SetLeftIndent(int indent) { m_leftIndent = indent; m_flags |= wxTEXT_ATTR_LEFT_INDENT; }
|
|
|
|
void SetRightIndent(int indent) { m_rightIndent = indent; m_flags |= wxTEXT_ATTR_RIGHT_INDENT; }
|
|
|
|
void SetFlags(long flags) { m_flags = flags; }
|
2001-05-26 23:28:28 -04:00
|
|
|
|
|
|
|
// accessors
|
2003-06-20 12:25:31 -04:00
|
|
|
bool HasTextColour() const { return m_colText.Ok() && HasFlag(wxTEXT_ATTR_TEXT_COLOUR) ; }
|
|
|
|
bool HasBackgroundColour() const { return m_colBack.Ok() && HasFlag(wxTEXT_ATTR_BACKGROUND_COLOUR) ; }
|
|
|
|
bool HasFont() const { return m_font.Ok() && HasFlag(wxTEXT_ATTR_FONT) ; }
|
|
|
|
bool HasAlignment() const { return (m_textAlignment != wxTEXT_ALIGNMENT_DEFAULT) || ((m_flags & wxTEXT_ATTR_ALIGNMENT) != 0) ; }
|
|
|
|
bool HasTabs() const { return (m_flags & wxTEXT_ATTR_TABS) != 0 ; }
|
|
|
|
bool HasLeftIndent() const { return (m_flags & wxTEXT_ATTR_LEFT_INDENT) != 0 ; }
|
|
|
|
bool HasRightIndent() const { return (m_flags & wxTEXT_ATTR_RIGHT_INDENT) != 0 ; }
|
|
|
|
bool HasFlag(long flag) const { return (m_flags & flag) != 0; }
|
2001-05-26 23:28:28 -04:00
|
|
|
|
|
|
|
const wxColour& GetTextColour() const { return m_colText; }
|
|
|
|
const wxColour& GetBackgroundColour() const { return m_colBack; }
|
|
|
|
const wxFont& GetFont() const { return m_font; }
|
2003-06-20 12:25:31 -04:00
|
|
|
wxTextAttrAlignment GetAlignment() const { return m_textAlignment; }
|
|
|
|
const wxArrayInt& GetTabs() const { return m_tabs; }
|
|
|
|
long GetLeftIndent() const { return m_leftIndent; }
|
|
|
|
long GetRightIndent() const { return m_rightIndent; }
|
|
|
|
long GetFlags() const { return m_flags; }
|
2001-05-26 23:28:28 -04:00
|
|
|
|
2001-06-18 13:41:33 -04:00
|
|
|
// returns false if we have any attributes set, true otherwise
|
|
|
|
bool IsDefault() const
|
|
|
|
{
|
2003-06-20 12:25:31 -04:00
|
|
|
return !HasTextColour() && !HasBackgroundColour() && !HasFont() && !HasAlignment() &&
|
|
|
|
!HasTabs() && !HasLeftIndent() && !HasRightIndent() ;
|
2001-06-18 13:41:33 -04:00
|
|
|
}
|
|
|
|
|
2001-11-26 09:50:50 -05:00
|
|
|
// return the attribute having the valid font and colours: it uses the
|
|
|
|
// attributes set in attr and falls back first to attrDefault and then to
|
|
|
|
// the text control font/colours for those attributes which are not set
|
|
|
|
static wxTextAttr Combine(const wxTextAttr& attr,
|
|
|
|
const wxTextAttr& attrDef,
|
|
|
|
const wxTextCtrlBase *text);
|
|
|
|
|
2001-05-26 23:28:28 -04:00
|
|
|
private:
|
2003-06-20 12:25:31 -04:00
|
|
|
long m_flags;
|
|
|
|
wxColour m_colText,
|
|
|
|
m_colBack;
|
|
|
|
wxFont m_font;
|
|
|
|
wxTextAttrAlignment m_textAlignment;
|
|
|
|
wxArrayInt m_tabs; // array of int: tab stops in 1/10 mm
|
|
|
|
int m_leftIndent; // left indent in 1/10 mm
|
|
|
|
int m_rightIndent; // right indent in 1/10 mm
|
2001-05-26 23:28:28 -04:00
|
|
|
};
|
|
|
|
|
1999-07-14 18:55:57 -04:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxTextCtrl: a single or multiple line text zone where user can enter and
|
|
|
|
// edit text
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class WXDLLEXPORT wxTextCtrlBase : public wxControl
|
|
|
|
#ifndef NO_TEXT_WINDOW_STREAM
|
2001-08-24 08:20:07 -04:00
|
|
|
, public wxSTD streambuf
|
1999-07-14 18:55:57 -04:00
|
|
|
#endif
|
|
|
|
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
// creation
|
|
|
|
// --------
|
|
|
|
|
|
|
|
wxTextCtrlBase();
|
2000-02-17 13:23:41 -05:00
|
|
|
~wxTextCtrlBase();
|
1999-07-14 18:55:57 -04:00
|
|
|
|
|
|
|
// accessors
|
|
|
|
// ---------
|
|
|
|
|
|
|
|
virtual wxString GetValue() const = 0;
|
|
|
|
virtual void SetValue(const wxString& value) = 0;
|
|
|
|
|
2002-01-08 20:32:02 -05:00
|
|
|
virtual wxString GetRange(long from, long to) const;
|
|
|
|
|
1999-07-14 18:55:57 -04:00
|
|
|
virtual int GetLineLength(long lineNo) const = 0;
|
|
|
|
virtual wxString GetLineText(long lineNo) const = 0;
|
|
|
|
virtual int GetNumberOfLines() const = 0;
|
|
|
|
|
|
|
|
virtual bool IsModified() const = 0;
|
|
|
|
virtual bool IsEditable() const = 0;
|
|
|
|
|
2002-07-21 14:51:04 -04:00
|
|
|
// more readable flag testing methods
|
|
|
|
bool IsSingleLine() const { return !(GetWindowStyle() & wxTE_MULTILINE); }
|
|
|
|
bool IsMultiLine() const { return !IsSingleLine(); }
|
|
|
|
|
1999-07-14 18:55:57 -04:00
|
|
|
// If the return values from and to are the same, there is no selection.
|
|
|
|
virtual void GetSelection(long* from, long* to) const = 0;
|
|
|
|
|
2001-11-13 22:50:11 -05:00
|
|
|
virtual wxString GetStringSelection() const;
|
2001-11-13 20:27:16 -05:00
|
|
|
|
1999-07-14 18:55:57 -04:00
|
|
|
// operations
|
|
|
|
// ----------
|
|
|
|
|
|
|
|
// editing
|
|
|
|
virtual void Clear() = 0;
|
|
|
|
virtual void Replace(long from, long to, const wxString& value) = 0;
|
|
|
|
virtual void Remove(long from, long to) = 0;
|
|
|
|
|
|
|
|
// load/save the controls contents from/to the file
|
|
|
|
virtual bool LoadFile(const wxString& file);
|
|
|
|
virtual bool SaveFile(const wxString& file = wxEmptyString);
|
|
|
|
|
|
|
|
// clears the dirty flag
|
|
|
|
virtual void DiscardEdits() = 0;
|
|
|
|
|
2001-08-15 08:45:53 -04:00
|
|
|
// set the max number of characters which may be entered in a single line
|
|
|
|
// text control
|
|
|
|
virtual void SetMaxLength(unsigned long WXUNUSED(len)) { }
|
|
|
|
|
1999-07-14 18:55:57 -04:00
|
|
|
// writing text inserts it at the current position, appending always
|
|
|
|
// inserts it at the end
|
|
|
|
virtual void WriteText(const wxString& text) = 0;
|
|
|
|
virtual void AppendText(const wxString& text) = 0;
|
|
|
|
|
2002-04-07 18:29:04 -04:00
|
|
|
// insert the character which would have resulted from this key event,
|
|
|
|
// return TRUE if anything has been inserted
|
|
|
|
virtual bool EmulateKeyPress(const wxKeyEvent& event);
|
|
|
|
|
2001-05-26 23:28:28 -04:00
|
|
|
// 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);
|
2003-06-20 12:25:31 -04:00
|
|
|
virtual bool GetStyle(long position, wxTextAttr& style);
|
2001-05-26 23:28:28 -04:00
|
|
|
virtual bool SetDefaultStyle(const wxTextAttr& style);
|
|
|
|
virtual const wxTextAttr& GetDefaultStyle() const;
|
|
|
|
|
1999-07-14 18:55:57 -04:00
|
|
|
// 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 = 0;
|
1999-07-15 09:42:27 -04:00
|
|
|
virtual bool PositionToXY(long pos, long *x, long *y) const = 0;
|
1999-07-14 18:55:57 -04:00
|
|
|
|
|
|
|
virtual void ShowPosition(long pos) = 0;
|
|
|
|
|
|
|
|
// Clipboard operations
|
|
|
|
virtual void Copy() = 0;
|
|
|
|
virtual void Cut() = 0;
|
|
|
|
virtual void Paste() = 0;
|
|
|
|
|
2001-06-26 16:59:19 -04:00
|
|
|
virtual bool CanCopy() const;
|
|
|
|
virtual bool CanCut() const;
|
|
|
|
virtual bool CanPaste() const;
|
1999-07-14 18:55:57 -04:00
|
|
|
|
|
|
|
// Undo/redo
|
|
|
|
virtual void Undo() = 0;
|
|
|
|
virtual void Redo() = 0;
|
|
|
|
|
|
|
|
virtual bool CanUndo() const = 0;
|
|
|
|
virtual bool CanRedo() const = 0;
|
|
|
|
|
|
|
|
// Insertion point
|
|
|
|
virtual void SetInsertionPoint(long pos) = 0;
|
|
|
|
virtual void SetInsertionPointEnd() = 0;
|
|
|
|
virtual long GetInsertionPoint() const = 0;
|
|
|
|
virtual long GetLastPosition() const = 0;
|
|
|
|
|
|
|
|
virtual void SetSelection(long from, long to) = 0;
|
2001-06-26 16:59:19 -04:00
|
|
|
virtual void SelectAll();
|
1999-07-14 18:55:57 -04:00
|
|
|
virtual void SetEditable(bool editable) = 0;
|
|
|
|
|
2001-10-19 12:27:15 -04:00
|
|
|
// override streambuf method
|
1999-07-14 18:55:57 -04:00
|
|
|
#ifndef NO_TEXT_WINDOW_STREAM
|
|
|
|
int overflow(int i);
|
|
|
|
#endif // NO_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);
|
1999-07-22 13:51:54 -04:00
|
|
|
wxTextCtrl& operator<<(const wxChar c);
|
1999-07-14 18:55:57 -04:00
|
|
|
|
|
|
|
// obsolete functions
|
|
|
|
#if WXWIN_COMPATIBILITY
|
|
|
|
bool Modified() const { return IsModified(); }
|
|
|
|
#endif
|
|
|
|
|
2000-01-17 20:22:56 -05:00
|
|
|
protected:
|
1999-07-14 18:55:57 -04:00
|
|
|
// the name of the last file loaded with LoadFile() which will be used by
|
|
|
|
// SaveFile() by default
|
|
|
|
wxString m_filename;
|
2000-02-17 13:23:41 -05:00
|
|
|
|
2001-05-26 23:28:28 -04:00
|
|
|
// the text style which will be used for any new text added to the control
|
|
|
|
wxTextAttr m_defaultStyle;
|
1999-07-14 18:55:57 -04:00
|
|
|
};
|
|
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// include the platform-dependent class definition
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
2002-04-01 06:41:59 -05:00
|
|
|
#if defined(__WXX11__)
|
|
|
|
#include "wx/x11/textctrl.h"
|
|
|
|
#elif defined(__WXUNIVERSAL__)
|
2001-06-26 16:59:19 -04:00
|
|
|
#include "wx/univ/textctrl.h"
|
|
|
|
#elif defined(__WXMSW__)
|
1999-07-14 18:55:57 -04:00
|
|
|
#include "wx/msw/textctrl.h"
|
1998-07-10 10:15:17 -04:00
|
|
|
#elif defined(__WXMOTIF__)
|
1999-07-14 18:55:57 -04:00
|
|
|
#include "wx/motif/textctrl.h"
|
1998-07-10 10:15:17 -04:00
|
|
|
#elif defined(__WXGTK__)
|
1999-07-14 18:55:57 -04:00
|
|
|
#include "wx/gtk/textctrl.h"
|
1998-08-14 20:23:28 -04:00
|
|
|
#elif defined(__WXMAC__)
|
1999-07-14 18:55:57 -04:00
|
|
|
#include "wx/mac/textctrl.h"
|
2003-03-22 01:18:36 -05:00
|
|
|
#elif defined(__WXCOCOA__)
|
|
|
|
#include "wx/cocoa/textctrl.h"
|
1999-07-27 23:38:12 -04:00
|
|
|
#elif defined(__WXPM__)
|
|
|
|
#include "wx/os2/textctrl.h"
|
1998-05-20 10:01:55 -04:00
|
|
|
#endif
|
|
|
|
|
2001-07-29 18:40:21 -04:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxTextCtrl events
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
2001-07-31 13:56:45 -04:00
|
|
|
#if !WXWIN_COMPATIBILITY_EVENT_TYPES
|
|
|
|
|
2001-07-29 18:40:21 -04:00
|
|
|
BEGIN_DECLARE_EVENT_TYPES()
|
|
|
|
DECLARE_EVENT_TYPE(wxEVT_COMMAND_TEXT_UPDATED, 7)
|
|
|
|
DECLARE_EVENT_TYPE(wxEVT_COMMAND_TEXT_ENTER, 8)
|
|
|
|
DECLARE_EVENT_TYPE(wxEVT_COMMAND_TEXT_URL, 13)
|
2001-08-15 08:45:53 -04:00
|
|
|
DECLARE_EVENT_TYPE(wxEVT_COMMAND_TEXT_MAXLEN, 14)
|
2001-07-29 18:40:21 -04:00
|
|
|
END_DECLARE_EVENT_TYPES()
|
|
|
|
|
2001-07-31 13:56:45 -04:00
|
|
|
#endif // !WXWIN_COMPATIBILITY_EVENT_TYPES
|
|
|
|
|
2001-07-29 18:40:21 -04:00
|
|
|
class WXDLLEXPORT wxTextUrlEvent : public wxCommandEvent
|
|
|
|
{
|
|
|
|
public:
|
2003-03-20 21:58:55 -05:00
|
|
|
wxTextUrlEvent(int winid, const wxMouseEvent& evtMouse,
|
2001-07-29 18:40:21 -04:00
|
|
|
long start, long end)
|
2003-03-20 21:58:55 -05:00
|
|
|
: wxCommandEvent(wxEVT_COMMAND_TEXT_URL, winid)
|
2002-05-03 15:41:22 -04:00
|
|
|
, m_evtMouse(evtMouse), m_start(start), m_end(end)
|
|
|
|
{ }
|
2001-07-29 18:40:21 -04:00
|
|
|
|
|
|
|
// get the mouse event which happend over the URL
|
|
|
|
const wxMouseEvent& GetMouseEvent() const { return m_evtMouse; }
|
|
|
|
|
|
|
|
// get the start of the URL
|
|
|
|
long GetURLStart() const { return m_start; }
|
|
|
|
|
|
|
|
// get the end of the URL
|
|
|
|
long GetURLEnd() const { return m_end; }
|
|
|
|
|
|
|
|
protected:
|
|
|
|
// the corresponding mouse event
|
|
|
|
wxMouseEvent m_evtMouse;
|
|
|
|
|
|
|
|
// the start and end indices of the URL in the text control
|
|
|
|
long m_start,
|
|
|
|
m_end;
|
|
|
|
|
|
|
|
private:
|
|
|
|
DECLARE_DYNAMIC_CLASS(wxTextUrlEvent)
|
|
|
|
|
|
|
|
public:
|
|
|
|
// for wxWin RTTI only, don't use
|
2002-05-03 15:41:22 -04:00
|
|
|
wxTextUrlEvent() : m_evtMouse(), m_start(0), m_end(0) { }
|
2001-07-29 18:40:21 -04:00
|
|
|
};
|
|
|
|
|
|
|
|
typedef void (wxEvtHandler::*wxTextUrlEventFunction)(wxTextUrlEvent&);
|
|
|
|
|
|
|
|
#define EVT_TEXT(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_TEXT_UPDATED, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
|
|
|
|
#define EVT_TEXT_ENTER(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_TEXT_ENTER, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
|
|
|
|
#define EVT_TEXT_URL(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_TEXT_URL, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) (wxTextUrlEventFunction) & fn, (wxObject *) NULL ),
|
2001-08-15 08:45:53 -04:00
|
|
|
#define EVT_TEXT_MAXLEN(id, fn) DECLARE_EVENT_TABLE_ENTRY( wxEVT_COMMAND_TEXT_MAXLEN, id, -1, (wxObjectEventFunction) (wxEventFunction) (wxCommandEventFunction) & fn, (wxObject *) NULL ),
|
2001-07-29 18:40:21 -04:00
|
|
|
|
2001-10-19 12:27:15 -04:00
|
|
|
#ifndef NO_TEXT_WINDOW_STREAM
|
|
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// wxStreamToTextRedirector: this class redirects all data sent to the given
|
|
|
|
// C++ stream to the wxTextCtrl given to its ctor during its lifetime.
|
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class WXDLLEXPORT wxStreamToTextRedirector
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
wxStreamToTextRedirector(wxTextCtrl *text, wxSTD ostream *ostr = NULL)
|
2001-10-19 12:30:46 -04:00
|
|
|
: m_ostr(ostr ? *ostr : wxSTD cout)
|
2001-10-19 12:27:15 -04:00
|
|
|
{
|
|
|
|
m_sbufOld = m_ostr.rdbuf();
|
|
|
|
m_ostr.rdbuf(text);
|
|
|
|
}
|
|
|
|
|
|
|
|
~wxStreamToTextRedirector()
|
|
|
|
{
|
|
|
|
m_ostr.rdbuf(m_sbufOld);
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
|
|
|
// the stream we're redirecting
|
|
|
|
wxSTD ostream& m_ostr;
|
|
|
|
|
|
|
|
// the old streambuf (before we changed it)
|
|
|
|
wxSTD streambuf *m_sbufOld;
|
|
|
|
};
|
|
|
|
|
|
|
|
#endif // !NO_TEXT_WINDOW_STREAM
|
|
|
|
|
2001-06-26 16:59:19 -04:00
|
|
|
#endif // wxUSE_TEXTCTRL
|
|
|
|
|
1998-05-20 10:01:55 -04:00
|
|
|
#endif
|
1998-08-14 20:23:28 -04:00
|
|
|
// _WX_TEXTCTRL_H_BASE_
|