Merged the wxPy_newswig branch into the HEAD branch (main trunk)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@24541 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Robin Dunn
328
wxPython/src/_textctrl.i
Normal file
328
wxPython/src/_textctrl.i
Normal file
@@ -0,0 +1,328 @@
|
||||
/////////////////////////////////////////////////////////////////////////////
|
||||
// Name: _textctrl.i
|
||||
// Purpose: SWIG interface defs for wxTextCtrl and related classes
|
||||
//
|
||||
// Author: Robin Dunn
|
||||
//
|
||||
// Created: 10-June-1998
|
||||
// RCS-ID: $Id$
|
||||
// Copyright: (c) 2003 by Total Control Software
|
||||
// Licence: wxWindows license
|
||||
/////////////////////////////////////////////////////////////////////////////
|
||||
|
||||
// Not a %module
|
||||
|
||||
|
||||
//---------------------------------------------------------------------------
|
||||
|
||||
%{
|
||||
DECLARE_DEF_STRING(TextCtrlNameStr);
|
||||
%}
|
||||
|
||||
//---------------------------------------------------------------------------
|
||||
%newgroup
|
||||
|
||||
enum {
|
||||
// Style flags
|
||||
wxTE_NO_VSCROLL,
|
||||
wxTE_AUTO_SCROLL,
|
||||
|
||||
wxTE_READONLY,
|
||||
wxTE_MULTILINE,
|
||||
wxTE_PROCESS_TAB,
|
||||
|
||||
// alignment flags
|
||||
wxTE_LEFT,
|
||||
wxTE_CENTER,
|
||||
wxTE_RIGHT,
|
||||
wxTE_CENTRE,
|
||||
|
||||
// this style means to use RICHEDIT control and does something only under
|
||||
// wxMSW and Win32 and is silently ignored under all other platforms
|
||||
wxTE_RICH,
|
||||
|
||||
wxTE_PROCESS_ENTER,
|
||||
wxTE_PASSWORD,
|
||||
|
||||
// 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
|
||||
wxTE_AUTO_URL,
|
||||
|
||||
// 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
|
||||
wxTE_NOHIDESEL,
|
||||
|
||||
// use wxHSCROLL to not wrap text at all, wxTE_LINEWRAP to wrap it at any
|
||||
// position and wxTE_WORDWRAP to wrap at words boundary
|
||||
wxTE_DONTWRAP,
|
||||
wxTE_LINEWRAP,
|
||||
wxTE_WORDWRAP,
|
||||
|
||||
// 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
|
||||
wxTE_RICH2,
|
||||
};
|
||||
|
||||
|
||||
enum wxTextAttrAlignment
|
||||
{
|
||||
wxTEXT_ALIGNMENT_DEFAULT,
|
||||
wxTEXT_ALIGNMENT_LEFT,
|
||||
wxTEXT_ALIGNMENT_CENTRE,
|
||||
wxTEXT_ALIGNMENT_CENTER = wxTEXT_ALIGNMENT_CENTRE,
|
||||
wxTEXT_ALIGNMENT_RIGHT,
|
||||
wxTEXT_ALIGNMENT_JUSTIFIED
|
||||
};
|
||||
|
||||
enum {
|
||||
// Flags to indicate which attributes are being applied
|
||||
wxTEXT_ATTR_TEXT_COLOUR,
|
||||
wxTEXT_ATTR_BACKGROUND_COLOUR,
|
||||
wxTEXT_ATTR_FONT_FACE,
|
||||
wxTEXT_ATTR_FONT_SIZE,
|
||||
wxTEXT_ATTR_FONT_WEIGHT,
|
||||
wxTEXT_ATTR_FONT_ITALIC,
|
||||
wxTEXT_ATTR_FONT_UNDERLINE,
|
||||
wxTEXT_ATTR_FONT,
|
||||
wxTEXT_ATTR_ALIGNMENT,
|
||||
wxTEXT_ATTR_LEFT_INDENT,
|
||||
wxTEXT_ATTR_RIGHT_INDENT,
|
||||
wxTEXT_ATTR_TABS
|
||||
};
|
||||
|
||||
//---------------------------------------------------------------------------
|
||||
|
||||
// wxTextAttr: a structure containing the visual attributes of a text
|
||||
class wxTextAttr
|
||||
{
|
||||
public:
|
||||
%nokwargs wxTextAttr;
|
||||
wxTextAttr();
|
||||
wxTextAttr(const wxColour& colText,
|
||||
const wxColour& colBack = wxNullColour,
|
||||
const wxFont& font = wxNullFont,
|
||||
wxTextAttrAlignment alignment = wxTEXT_ALIGNMENT_DEFAULT);
|
||||
|
||||
// operations
|
||||
void Init();
|
||||
|
||||
// setters
|
||||
void SetTextColour(const wxColour& colText);
|
||||
void SetBackgroundColour(const wxColour& colBack);
|
||||
void SetFont(const wxFont& font, long flags = wxTEXT_ATTR_FONT);
|
||||
void SetAlignment(wxTextAttrAlignment alignment);
|
||||
void SetTabs(const wxArrayInt& tabs);
|
||||
void SetLeftIndent(int indent);
|
||||
void SetRightIndent(int indent);
|
||||
void SetFlags(long flags);
|
||||
|
||||
// accessors
|
||||
bool HasTextColour() const;
|
||||
bool HasBackgroundColour() const;
|
||||
bool HasFont() const;
|
||||
bool HasAlignment() const;
|
||||
bool HasTabs() const;
|
||||
bool HasLeftIndent() const;
|
||||
bool HasRightIndent() const;
|
||||
bool HasFlag(long flag) const;
|
||||
|
||||
const wxColour& GetTextColour() const;
|
||||
const wxColour& GetBackgroundColour() const;
|
||||
const wxFont& GetFont() const;
|
||||
wxTextAttrAlignment GetAlignment() const;
|
||||
const wxArrayInt& GetTabs() const;
|
||||
long GetLeftIndent() const;
|
||||
long GetRightIndent() const;
|
||||
long GetFlags() const;
|
||||
|
||||
// returns false if we have any attributes set, true otherwise
|
||||
bool IsDefault() const;
|
||||
|
||||
// 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 wxTextCtrl *text);
|
||||
};
|
||||
|
||||
//---------------------------------------------------------------------------
|
||||
|
||||
// wxTextCtrl: a single or multiple line text zone where user can enter and
|
||||
// edit text
|
||||
class wxTextCtrl : public wxControl
|
||||
{
|
||||
public:
|
||||
%addtofunc wxTextCtrl "self._setOORInfo(self)"
|
||||
%addtofunc wxTextCtrl() ""
|
||||
|
||||
wxTextCtrl(wxWindow* parent, wxWindowID id,
|
||||
const wxString& value = wxPyEmptyString,
|
||||
const wxPoint& pos = wxDefaultPosition,
|
||||
const wxSize& size = wxDefaultSize,
|
||||
long style = 0,
|
||||
const wxValidator& validator = wxDefaultValidator,
|
||||
const wxString& name = wxPyTextCtrlNameStr);
|
||||
%name(PreTextCtrl)wxTextCtrl();
|
||||
|
||||
bool Create(wxWindow* parent, wxWindowID id,
|
||||
const wxString& value = wxPyEmptyString,
|
||||
const wxPoint& pos = wxDefaultPosition,
|
||||
const wxSize& size = wxDefaultSize,
|
||||
long style = 0,
|
||||
const wxValidator& validator = wxDefaultValidator,
|
||||
const wxString& name = wxPyTextCtrlNameStr);
|
||||
|
||||
|
||||
virtual wxString GetValue() const;
|
||||
virtual void SetValue(const wxString& value);
|
||||
|
||||
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
|
||||
bool IsSingleLine() const;
|
||||
bool IsMultiLine() const;
|
||||
|
||||
// If the return values from and to are the same, there is no selection.
|
||||
virtual void GetSelection(long* OUTPUT, long* OUTPUT) const;
|
||||
|
||||
virtual wxString GetStringSelection() const;
|
||||
|
||||
|
||||
// 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 = wxPyEmptyString);
|
||||
|
||||
// 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 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*/ void PositionToXY(long pos, long *OUTPUT, long *OUTPUT) const;
|
||||
|
||||
virtual void ShowPosition(long pos);
|
||||
|
||||
// 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 long GetLastPosition() const;
|
||||
|
||||
virtual void SetSelection(long from, long to);
|
||||
virtual void SelectAll();
|
||||
virtual void SetEditable(bool editable);
|
||||
|
||||
#ifdef __WXMSW__
|
||||
// Caret handling (Windows only)
|
||||
bool ShowNativeCaret(bool show = true);
|
||||
bool HideNativeCaret();
|
||||
#endif
|
||||
|
||||
%extend {
|
||||
// TODO: Add more file-like methods
|
||||
void write(const wxString& text) {
|
||||
self->AppendText(text);
|
||||
}
|
||||
}
|
||||
|
||||
// TODO: replace this when the method is really added to wxTextCtrl
|
||||
%extend {
|
||||
wxString GetString(long from, long to) {
|
||||
return self->GetValue().Mid(from, to - from);
|
||||
}
|
||||
}
|
||||
|
||||
};
|
||||
|
||||
//---------------------------------------------------------------------------
|
||||
|
||||
|
||||
%constant wxEventType wxEVT_COMMAND_TEXT_UPDATED;
|
||||
%constant wxEventType wxEVT_COMMAND_TEXT_ENTER;
|
||||
%constant wxEventType wxEVT_COMMAND_TEXT_URL;
|
||||
%constant wxEventType wxEVT_COMMAND_TEXT_MAXLEN;
|
||||
|
||||
|
||||
class wxTextUrlEvent : public wxCommandEvent
|
||||
{
|
||||
public:
|
||||
wxTextUrlEvent(int winid, const wxMouseEvent& evtMouse,
|
||||
long start, long end);
|
||||
|
||||
// get the mouse event which happend over the URL
|
||||
const wxMouseEvent& GetMouseEvent();
|
||||
|
||||
// get the start of the URL
|
||||
long GetURLStart() const;
|
||||
|
||||
// get the end of the URL
|
||||
long GetURLEnd() const;
|
||||
};
|
||||
|
||||
|
||||
%pythoncode {
|
||||
EVT_TEXT = wx.PyEventBinder( wxEVT_COMMAND_TEXT_UPDATED, 1)
|
||||
EVT_TEXT_ENTER = wx.PyEventBinder( wxEVT_COMMAND_TEXT_ENTER, 1)
|
||||
EVT_TEXT_URL = wx.PyEventBinder( wxEVT_COMMAND_TEXT_URL, 1)
|
||||
EVT_TEXT_MAXLEN = wx.PyEventBinder( wxEVT_COMMAND_TEXT_MAXLEN, 1)
|
||||
}
|
||||
|
||||
|
||||
|
||||
|
||||
//---------------------------------------------------------------------------
|
||||
|
||||
Reference in New Issue
Block a user