PyFrame Guide to wxPython
Copyright and License information Home
__ A B C D E F G H I L M P R S T U V W
wxStyledTextCtrl - wxStyledTextEvent
__init__
Clone
GetAlt
GetControl
GetDragAllowMove
GetDragResult
GetDragText
GetFoldLevelNow
GetFoldLevelPrev
GetKey
GetLength
GetLine
GetLinesAdded
GetListType
GetLParam
GetMargin
GetMessage
GetModificationType
GetModifiers
GetPosition
GetShift
GetText
GetWParam
GetX
GetY
SetDragAllowMove
SetDragResult
SetDragText
SetFoldLevelNow
SetFoldLevelPrev
SetKey
SetLength
SetLine
SetLinesAdded
SetListType
SetLParam
SetMargin
SetMessage
SetModificationType
SetModifiers
SetPosition
SetText
SetWParam
SetX
SetY
Summary:
The wxStyledTextEvent is the interface between Scintilla notifications and your Python program. wxStyledTextEvent inherits from wxCommandEvent and inherits familiar methods from that class; but many of them (e.g., IsChecked()), don't make any sense for the STC. However, wxCommandEvent inherits from wxEvent; methods from the wxEvent class can be useful (e.g., GetId() and Skip()).
There are two basic types of events that will be sent to a wxPython application, EVT_STC_CHANGE and all the others. The former is sent to your application when the Scintilla event NotifyChange occurs. This one occurs whenever a change is made to the text of the document, but not for changes in styling information. This event is simple: there's no significant information in the event object other than the fact that it occurred and the ID of the STC.
The other events are sent to your app when the internal Scintilla event NotifyParent occurs. Many of these events have little information aside from the event type and the STC id. Some others have information about position, keypress, modifiers (alt, shift, ctrl). Others have information about text content, folding, etc. You need to examine the event itself to see what's provided: See this page and Events for specifics.
You can control what types of modifications will fire a EVT_STC_CHANGE and EVT_STC_MODIFIED event with the SetModEventMask command. Important! No modifications may be performed while servicing these two events!!
wxStyledTextEvent attributes:
These are the attributes specific to this event (not including any due to inheritance). The names of the C-language variables are shown. There's no direct access to these variables, you need to use the methods shown on this page to access them.
int m_position;
int m_key;
int m_modifiers;
int m_modificationType;
wxString m_text;
int m_length;
int m_linesAdded;
int m_line;
int m_foldLevelNow;
int m_foldLevelPrev;
int m_margin;
int m_message;
int m_wParam;
int m_lParam;
int m_listType;
int m_x;
int m_y;
wxString m_dragText;
bool m_dragAllowMove;
wxDragResult m_dragResult;Note that wxPython handles conversions to and from wxWindows-specific types such as wxString.
----
The values for m_modificationType are shown below. These can be used in your Python program.
wxSTC_MOD_INSERTTEXT
wxSTC_MOD_DELETETEXT
wxSTC_MOD_CHANGESTYLE
wxSTC_MOD_CHANGEFOLD
wxSTC_PERFORMED_USER
wxSTC_PERFORMED_UNDO
wxSTC_PERFORMED_REDO
wxSTC_LASTSTEPINUNDOREDO
wxSTC_MOD_CHANGEMARKER
wxSTC_MOD_BEFOREINSERT
wxSTC_MOD_BEFOREDELETE
wxSTC_MODEVENTMASKALL----
__init__(commandType,id)
Create a new event object. CommandType is the type of event, such as wxEVT_STC_CHANGE, wxEVT_STC_STYLENEEDED, etc. id is the control id. Note that a user should not ordinarily need to create an event. Most of the Set methods are not used by user code, with the exception of perhaps SetDragResult or SetDragAllowMove.
top
----
Clone
Create a copy of the event. Required by wxWindows event system.
top
----
GetAlt
Returns the state of the ALT bit in the m_modifiers attribute; i.e., is 1 if the ALT key was pressed for this event. Valid for EVT_STC_MARGINCLICK and EVT_STC_KEY (EVT_STC_KEY not sent in win32).
top
----
GetControl
Returns the state of the CTRL bit in the m_modifiers attribute; i.e., is 1 if the CTRL key was pressed for this event. Valid for EVT_STC_MARGINCLICK and EVT_STC_KEY (EVT_STC_KEY not sent in win32).
top
----
GetDragAllowMove
Get the value of the m_dragAllowMove. Always initially set TRUE for the EVT_STC_START_DRAG event. See SetDragAllowMove for more information.
top
----
GetDragResult
Get the value of m_dragResult. See SetDragResult.
top
----
GetDragText
Get the value of m_dragText. This is a string that contains text to be dropped into the STC.
top
----
GetFoldLevelNow
Get the value of m_foldLevelNow. The fold level after to a change in folding level. See also GetFoldLevelPrev.
top
----
GetFoldLevelPrev
Get the value of m_foldLevelPrev. The fold level prior to a change in folding level. GetModificationType will be wxSTC_MOD_CHANGEFOLD | wxSTC_MOD_CHANGEMARKER. Sent in response to a change in fold level sent from a client using SetFoldLevel or due to a change in fold level performed by a lexer that supports folding (if applicable).
top
----
GetKey
Returns the value of m_key. This is valid for EVT_STC_CHARADDED and EVT_STC_KEY (ECT_STC_KEY not used in win32).
top
----
GetLength
Returns the value of m_length. This is valid for EVT_STC_NEEDSHOWN and EVT_STC_MODIFIED.
top
----
GetLine
Returns the value of m_line. Valid for EVT_STC_MODIFIED. GetModificationType will be wxSTC_MOD_CHANGEFOLD | wxSTC_MOD_CHANGEMARKER. Sent in response to a change in fold level sent from a client using SetFoldLevel or due to a change in fold level performed by a lexer that supports folding.
top
----
GetLinesAdded
Returns the value of m_linesAdded. Valid for EVT_STC_MODIFIED when GetModificationType() returns one of:
wxSTC_MOD_BEFOREINSERT | wxSTC_PERFORMED_USER
wxSTC_MOD_INSERTTEXT | wxSTC_PERFORMED_USER
wxSTC_PERFORMED_UNDO | wxSTC_MOD_INSERTTEXT
wxSTC_PERFORMED_UNDO | wxSTC_MOD_DELETETEXT
wxSTC_PERFORMED_UNDO | wxSTC_MOD_INSERTTEXT | wxSTC_LASTSTEPINUNDOREDO
wxSTC_PERFORMED_UNDO | wxSTC_MOD_DELETETEXT | wxSTC_LASTSTEPINUNDOREDO
wxSTC_PERFORMED_REDO | wxSTC_MOD_INSERTTEXT
wxSTC_PERFORMED_REDO | wxSTC_MOD_DELETETEXT
wxSTC_PERFORMED_REDO | wxSTC_MOD_INSERTTEXT | wxSTC_LASTSTEPINUNDOREDO
wxSTC_PERFORMED_REDO | wxSTC_MOD_DELETETEXT | wxSTC_LASTSTEPINUNDOREDO
top
----
GetListType
Get the value of m_listType. Valid for EVT_STC_USERLISTSELECTION. Use GetText to get the value of the text returned from this user list.
top
----
GetLParam
Get the value of m_lParam. Valid for EVT_STC_MACRORECORD.
top
----
GetMargin
Returns the value of m_margin. This is the margin number where the click occurred. Valid for EVT_STC_MARGINCLICK. Note that the m_modifieds variable is valid for this event, so you can use GetModifiers or the more convenient GetAlt(), GetControl() and GetShift() methods to determine the state of the modifier keys when the margin was clicked.
top
----
GetMessage
Get the value of m_message. Valid for EVT_STC_MACRORECORD.
top
----
GetModificationType
Get the value of m_modificationType. Used with EVT_STC_MODIFIED to indicate the modification type: see the Modification Types table.
top
----
GetModifiers
Returns the value of m_modifiers. Valid for EVT_STC_MARGINCLICK and EVT_STC_KEY (EVT_STC_KEY not sent in win32).
top
----
GetPosition
Returns the value of m_position. Valid for wxEVT_STC_START_DRAG (lowest character position of start of selection), wxEVT_STC_DO_DROP and wxEVT_STC_DRAG_OVER (both of these send the character position of drop point x,y location), EVT_STC_DWELLEND and EVT_STC_DWELLSTART (both of these send the character position nearest the dwell point or INVALID_POSITION = -1 if not near any text), EVT_STC_STYLENEEDED (last character position where styling is needed) and EVT_STC_MODIFIED when GetModificationType() returns:
wxSTC_MOD_CHANGEMARKER (position may be zero, see Document.cxx in Scintilla src)
wxSTC_MOD_CHANGEFOLD | wxSTC_MOD_CHANGEMARKER
wxSTC_MOD_BEFOREDELETE | wxSTC_PERFORMED_USER
wxSTC_MOD_DELETETEXT | wxSTC_PERFORMED_USER
wxSTC_MOD_BEFOREINSERT | wxSTC_PERFORMED_USER
wxSTC_MOD_INSERTTEXT | wxSTC_PERFORMED_USER
wxSTC_PERFORMED_UNDO | wxSTC_MOD_INSERTTEXT | wxSTC_LASTSTEPINUNDOREDO
wxSTC_PERFORMED_UNDO | wxSTC_MOD_DELETETEXT | wxSTC_LASTSTEPINUNDOREDO
wxSTC_PERFORMED_REDO | wxSTC_MOD_INSERTTEXT
wxSTC_PERFORMED_REDO | wxSTC_MOD_DELETETEXT
wxSTC_PERFORMED_REDO | wxSTC_MOD_INSERTTEXT | wxSTC_LASTSTEPINUNDOREDO
wxSTC_PERFORMED_REDO | wxSTC_MOD_DELETETEXT | wxSTC_LASTSTEPINUNDOREDO
wxSTC_MOD_CHANGESTYLE | wxSTC_PERFORMED_USER
top
----
GetShift
Returns the state of the SHIFT bit in the m_modifiers attribute; i.e., is 1 if the SHIFT key was pressed for this event. Valid for EVT_STC_MARGINCLICK and EVT_STC_KEY (EVT_STC_KEY not sent in win32).
top
----
GetText
Get the value of the m_text variable. This is valid for wxEVT_STC_USERLISTSELECTION, wxEVT_STC_URIDROPPED, and wxEVT_STC_MODIFIED when GetModificationType() returns:
wxSTC_MOD_BEFOREDELETE | wxSTC_PERFORMED_USER
wxSTC_MOD_INSERTTEXT | wxSTC_PERFORMED_USER
wxSTC_PERFORMED_UNDO | wxSTC_MOD_INSERTTEXT | wxSTC_LASTSTEPINUNDOREDO
wxSTC_PERFORMED_UNDO | wxSTC_MOD_DELETETEXT | wxSTC_LASTSTEPINUNDOREDO
wxSTC_PERFORMED_REDO | wxSTC_MOD_INSERTTEXT
wxSTC_PERFORMED_REDO | wxSTC_MOD_DELETETEXT
wxSTC_PERFORMED_REDO | wxSTC_MOD_INSERTTEXT | wxSTC_LASTSTEPINUNDOREDO
wxSTC_PERFORMED_REDO | wxSTC_MOD_DELETETEXT | wxSTC_LASTSTEPINUNDOREDO
top
----
GetWParam
Get the value of m_wParam. Valid for EVT_STC_MACRORECORD.
top
----
GetX
GetY
Get the value of the m_x or m_y variables. These are valid for exEVT_STC_DO_DROP, wxEVT_STC_DRAG_OVER, EVT_STC_DWELLEND and EVT_STC_DWELLSTART.
top
----
SetDragAllowMove
When a drop source, control which operations may take place. Use one of the wxPython defined values:
wxDrag_CopyOnly: allow only copying
wxDrag_AllowMove: allow moving and copying
wxDrag_DefaultMove: the default operation is move rather than copy.
top
----
SetDragResult
Set the value of the m_dragResult variable. You can use one of the wxPython defined values:
wxDragError: error prevented the d&d operation from completing
wxDragNone: drag target didn't accept the data
wxDragCopy: the data was successfully copied
wxDragMove: the data was successfully moved (MSW only)
wxDragLink: operation is a drag-link
wxDragCancel: the operation was cancelled by user (not an error)
top
----
SetDragText
Set the value of m_dragText.
top
----
SetFoldLevelNow
Set the value of m_foldLevelNow.
top
----
SetFoldLevelPrev
Set the value of m_foldLevelPrev.
top
----
SetKey
Set the value of m_key.
top
----
SetLength
Set the value of m_length.
top
----
SetLine
Set the value of m_line.
top
----
SetLinesAdded
Set the value of m_linesAdded.
top
----
SetListType
Set the value of m_listType.
top
----
SetLParam
Set the value of m_lParam.
top
----
SetMargin
Set the value of m_margin.
top
----
SetMessage
Set the value of m_message.
top
----
SetModificationType
Set the value of m_modificationType.
top
----
SetModifiers
Set the value of m_modifiers.
top
----
SetPosition
Set the value of m_position.
top
----
SetText
Set the value of m_text.
top
----
SetWParam
Set the value of m_wParam.
top
----
SetX
Set the value of m_x.
top
----
SetY
Set the value of m_y.
top
----