]> git.saurik.com Git - wxWidgets.git/blame - interface/stc/stc.h
mac paths updated
[wxWidgets.git] / interface / stc / stc.h
CommitLineData
23324ae1
FM
1/////////////////////////////////////////////////////////////////////////////
2// Name: stc/stc.h
e54c96f1 3// Purpose: interface of wxStyledTextEvent
23324ae1
FM
4// Author: wxWidgets team
5// RCS-ID: $Id$
6// Licence: wxWindows license
7/////////////////////////////////////////////////////////////////////////////
8
9/**
10 @class wxStyledTextEvent
11 @headerfile stc.h wx/stc/stc.h
7c913512 12
23324ae1 13 The type of events sent from wxStyledTextCtrl.
7c913512 14
23324ae1 15 TODO
7c913512 16
23324ae1
FM
17 @library{wxbase}
18 @category{FIXME}
19*/
20class wxStyledTextEvent : public wxCommandEvent
21{
22public:
23 //@{
24 /**
25
26 */
27 wxStyledTextEvent(wxEventType commandType = 0, int id = 0);
7c913512 28 wxStyledTextEvent(const wxStyledTextEvent& event);
23324ae1
FM
29 //@}
30
31 /**
32
33 */
328f5751 34 wxEvent* Clone() const;
23324ae1
FM
35
36 /**
37
38 */
328f5751 39 bool GetAlt() const;
23324ae1
FM
40
41 /**
42
43 */
328f5751 44 bool GetControl() const;
23324ae1
FM
45
46 /**
47
48 */
49 bool GetDragAllowMove();
50
51 /**
52
53 */
54 wxDragResult GetDragResult();
55
56 /**
57
58 */
59 wxString GetDragText();
60
61 /**
62
63 */
328f5751 64 int GetFoldLevelNow() const;
23324ae1
FM
65
66 /**
67
68 */
328f5751 69 int GetFoldLevelPrev() const;
23324ae1
FM
70
71 /**
72
73 */
328f5751 74 int GetKey() const;
23324ae1
FM
75
76 /**
77
78 */
328f5751 79 int GetLParam() const;
23324ae1
FM
80
81 /**
82
83 */
328f5751 84 int GetLength() const;
23324ae1
FM
85
86 /**
87
88 */
328f5751 89 int GetLine() const;
23324ae1
FM
90
91 /**
92
93 */
328f5751 94 int GetLinesAdded() const;
23324ae1
FM
95
96 /**
97
98 */
328f5751 99 int GetListType() const;
23324ae1
FM
100
101 /**
102
103 */
328f5751 104 int GetMargin() const;
23324ae1
FM
105
106 /**
107
108 */
328f5751 109 int GetMessage() const;
23324ae1
FM
110
111 /**
112
113 */
328f5751 114 int GetModificationType() const;
23324ae1
FM
115
116 /**
117
118 */
328f5751 119 int GetModifiers() const;
23324ae1
FM
120
121 /**
122
123 */
328f5751 124 int GetPosition() const;
23324ae1
FM
125
126 /**
127
128 */
328f5751 129 bool GetShift() const;
23324ae1
FM
130
131 /**
132
133 */
328f5751 134 wxString GetText() const;
23324ae1
FM
135
136 /**
137
138 */
328f5751 139 int GetWParam() const;
23324ae1
FM
140
141 /**
142
143 */
328f5751 144 int GetX() const;
23324ae1
FM
145
146 /**
147
148 */
328f5751 149 int GetY() const;
23324ae1
FM
150
151 /**
152
153 */
154 void SetDragAllowMove(bool val);
155
156 /**
157
158 */
159 void SetDragResult(wxDragResult val);
160
161 /**
162
163 */
164 void SetDragText(const wxString& val);
165
166 /**
167
168 */
169 void SetFoldLevelNow(int val);
170
171 /**
172
173 */
174 void SetFoldLevelPrev(int val);
175
176 /**
177
178 */
179 void SetKey(int k);
180
181 /**
182
183 */
184 void SetLParam(int val);
185
186 /**
187
188 */
189 void SetLength(int len);
190
191 /**
192
193 */
194 void SetLine(int val);
195
196 /**
197
198 */
199 void SetLinesAdded(int num);
200
201 /**
202
203 */
204 void SetListType(int val);
205
206 /**
207
208 */
209 void SetMargin(int val);
210
211 /**
212
213 */
214 void SetMessage(int val);
215
216 /**
217
218 */
219 void SetModificationType(int t);
220
221 /**
222
223 */
224 void SetModifiers(int m);
225
226 /**
227
228 */
229 void SetPosition(int pos);
230
231 /**
232
233 */
234 void SetText(const wxString& t);
235
236 /**
237
238 */
239 void SetWParam(int val);
240
241 /**
242
243 */
4cc4bfaf 244 void SetX(int val);
23324ae1
FM
245
246 /**
247
248 */
4cc4bfaf 249 void SetY(int val);
23324ae1
FM
250};
251
252
e54c96f1 253
23324ae1
FM
254/**
255 @class wxStyledTextCtrl
256 @headerfile stc.h wx/stc/stc.h
7c913512 257
23324ae1 258 A wxWidgets implementation of the Scintilla source code editing component.
7c913512 259
23324ae1 260 As well as features found in standard text editing components, Scintilla
7c913512 261 includes
23324ae1 262 features especially useful when editing and debugging source code. These
7c913512 263 include
23324ae1 264 support for syntax styling, error indicators, code completion and call tips.
7c913512
FM
265 The
266 selection margin can contain markers like those used in debuggers to indicate
267 breakpoints and the current line. Styling choices are more open than with many
268 editors, allowing the use of proportional fonts, bold and italics, multiple
23324ae1 269 foreground and background colours and multiple fonts.
7c913512 270
23324ae1
FM
271 wxStyledTextCtrl is a 1 to 1 mapping of "raw" scintilla interface, whose
272 documentation
273 can be found in the Scintilla website.
7c913512 274
23324ae1
FM
275 @library{wxbase}
276 @category{stc}
7c913512 277
e54c96f1 278 @see wxStyledTextEvent
23324ae1
FM
279*/
280class wxStyledTextCtrl : public wxControl
281{
282public:
283 /**
284 Ctor.
285 */
4cc4bfaf 286 wxStyledTextCtrl::wxStyledTextCtrl(wxWindow* parent,
23324ae1
FM
287 wxWindowID id = wxID_ANY,
288 const wxPoint pos = wxDefaultPosition,
289 const wxSize size = wxDefaultSize,
290 long style = 0,
291 const wxString name = "stcwindow");
292
293 /**
294 Extend life of document.
295 */
296 void AddRefDocument(void* docPointer);
297
298 /**
299 Add array of cells to document.
300 */
301 void AddStyledText(const wxMemoryBuffer& data);
302
303 /**
304 BEGIN generated section. The following code is automatically generated
305 by gen_iface.py. Do not edit this file. Edit stc.h.in instead
306 and regenerate
307 Add text to the document at current position.
308 */
309 void AddText(const wxString& text);
310
311 /**
312 The following methods are nearly equivallent to their similarly named
313 cousins above. The difference is that these methods bypass wxString
314 and always use a char* even if used in a unicode build of wxWidgets.
315 In that case the character data will be utf-8 encoded since that is
316 what is used internally by Scintilla in unicode builds.
317 Add text to the document at current position.
318 */
319 void AddTextRaw(const char* text);
320
321 /**
322 Enlarge the document to a particular size of text bytes.
323 */
324 void Allocate(int bytes);
325
326 /**
327 Append a string to the end of the document without changing the selection.
328 */
329 void AppendText(const wxString& text);
330
331 /**
332 Append a string to the end of the document without changing the selection.
333 */
334 void AppendTextRaw(const char* text);
335
336 /**
337 Is there an auto-completion list visible?
338 */
339 bool AutoCompActive();
340
341 /**
342 Remove the auto-completion list from the screen.
343 */
344 void AutoCompCancel();
345
346 /**
347 User has selected an item so remove the list and insert the selection.
348 */
349 void AutoCompComplete();
350
351 /**
352 Retrieve whether or not autocompletion is hidden automatically when nothing
353 matches.
354 */
355 bool AutoCompGetAutoHide();
356
357 /**
358 Retrieve whether auto-completion cancelled by backspacing before start.
359 */
360 bool AutoCompGetCancelAtStart();
361
362 /**
363 Retrieve whether a single item auto-completion list automatically choose the
364 item.
365 */
366 bool AutoCompGetChooseSingle();
367
368 /**
369 Get currently selected item position in the auto-completion list
370 */
371 int AutoCompGetCurrent();
372
373 /**
374 Retrieve whether or not autocompletion deletes any word characters
375 after the inserted text upon completion.
376 */
377 bool AutoCompGetDropRestOfWord();
378
379 /**
380 Retrieve state of ignore case flag.
381 */
382 bool AutoCompGetIgnoreCase();
383
384 /**
385 Set the maximum height, in rows, of auto-completion and user lists.
386 */
387 int AutoCompGetMaxHeight();
388
389 /**
390 Get the maximum width, in characters, of auto-completion and user lists.
391 */
392 int AutoCompGetMaxWidth();
393
394 /**
395 Retrieve the auto-completion list separator character.
396 */
397 int AutoCompGetSeparator();
398
399 /**
400 Retrieve the auto-completion list type-separator character.
401 */
402 int AutoCompGetTypeSeparator();
403
404 /**
405 Retrieve the position of the caret when the auto-completion list was displayed.
406 */
407 int AutoCompPosStart();
408
409 /**
410 Select the item in the auto-completion list that starts with a string.
411 */
412 void AutoCompSelect(const wxString& text);
413
414 /**
415 Set whether or not autocompletion is hidden automatically when nothing matches.
416 */
417 void AutoCompSetAutoHide(bool autoHide);
418
419 /**
420 Should the auto-completion list be cancelled if the user backspaces to a
421 position before where the box was created.
422 */
423 void AutoCompSetCancelAtStart(bool cancel);
424
425 /**
426 Should a single item auto-completion list automatically choose the item.
427 */
428 void AutoCompSetChooseSingle(bool chooseSingle);
429
430 /**
431 Set whether or not autocompletion deletes any word characters
432 after the inserted text upon completion.
433 */
434 void AutoCompSetDropRestOfWord(bool dropRestOfWord);
435
436 /**
437 Define a set of characters that when typed will cause the autocompletion to
438 choose the selected item.
439 */
440 void AutoCompSetFillUps(const wxString& characterSet);
441
442 /**
443 Set whether case is significant when performing auto-completion searches.
444 */
445 void AutoCompSetIgnoreCase(bool ignoreCase);
446
447 /**
448 Set the maximum height, in rows, of auto-completion and user lists.
449 The default is 5 rows.
450 */
451 void AutoCompSetMaxHeight(int rowCount);
452
453 /**
454 Set the maximum width, in characters, of auto-completion and user lists.
455 Set to 0 to autosize to fit longest item, which is the default.
456 */
457 void AutoCompSetMaxWidth(int characterCount);
458
459 /**
460 Change the separator character in the string setting up an auto-completion list.
461 Default is space but can be changed if items contain space.
462 */
463 void AutoCompSetSeparator(int separatorCharacter);
464
465 /**
466 Change the type-separator character in the string setting up an auto-completion
467 list.
468 Default is '?' but can be changed if items contain '?'.
469 */
470 void AutoCompSetTypeSeparator(int separatorCharacter);
471
472 /**
473 Display a auto-completion list.
474 The lenEntered parameter indicates how many characters before
475 the caret should be used to provide context.
476 */
477 void AutoCompShow(int lenEntered, const wxString& itemList);
478
479 /**
480 Define a set of character that when typed cancel the auto-completion list.
481 */
482 void AutoCompStops(const wxString& characterSet);
483
484 /**
485 Dedent the selected lines.
486 */
487 void BackTab();
488
489 /**
490 Start a sequence of actions that is undone and redone as a unit.
491 May be nested.
492 */
493 void BeginUndoAction();
494
495 /**
496 Highlight the character at a position indicating there is no matching brace.
497 */
498 void BraceBadLight(int pos);
499
500 /**
501 Highlight the characters at two positions.
502 */
503 void BraceHighlight(int pos1, int pos2);
504
505 /**
506 Find the position of a matching brace or INVALID_POSITION if no match.
507 */
508 int BraceMatch(int pos);
509
510 /**
511 Is there an active call tip?
512 */
513 bool CallTipActive();
514
515 /**
516 Remove the call tip from the screen.
517 */
518 void CallTipCancel();
519
520 /**
521 Retrieve the position where the caret was before displaying the call tip.
522 */
523 int CallTipPosAtStart();
524
525 /**
526 Set the background colour for the call tip.
527 */
528 void CallTipSetBackground(const wxColour& back);
529
530 /**
531 Set the foreground colour for the call tip.
532 */
533 void CallTipSetForeground(const wxColour& fore);
534
535 /**
536 Set the foreground colour for the highlighted part of the call tip.
537 */
538 void CallTipSetForegroundHighlight(const wxColour& fore);
539
540 /**
541 Highlight a segment of the definition.
542 */
543 void CallTipSetHighlight(int start, int end);
544
545 /**
546 Show a call tip containing a definition near position pos.
547 */
548 void CallTipShow(int pos, const wxString& definition);
549
550 /**
551 Enable use of STYLE_CALLTIP and set call tip tab size in pixels.
552 */
553 void CallTipUseStyle(int tabSize);
554
555 /**
556 Will a paste succeed?
557 */
558 bool CanPaste();
559
560 /**
561 Are there any redoable actions in the undo history?
562 */
563 bool CanRedo();
564
565 /**
566 Are there any undoable actions in the undo history?
567 */
568 bool CanUndo();
569
570 /**
571 Cancel any modes such as call tip or auto-completion list display.
572 */
573 void Cancel();
574
575 /**
576 Move caret left one character.
577 */
578 void CharLeft();
579
580 /**
581 Move caret left one character extending selection to new caret position.
582 */
583 void CharLeftExtend();
584
585 /**
586 Move caret left one character, extending rectangular selection to new caret
587 position.
588 */
589 void CharLeftRectExtend();
590
591 /**
592 Move caret right one character.
593 */
594 void CharRight();
595
596 /**
597 Move caret right one character extending selection to new caret position.
598 */
599 void CharRightExtend();
600
601 /**
602 Move caret right one character, extending rectangular selection to new caret
603 position.
604 */
605 void CharRightRectExtend();
606
607 /**
608 Set the last x chosen value to be the caret x position.
609 */
610 void ChooseCaretX();
611
612 /**
613 Clear the selection.
614 */
615 void Clear();
616
617 /**
618 Delete all text in the document.
619 */
620 void ClearAll();
621
622 /**
623 Set all style bytes to 0, remove all folding information.
624 */
625 void ClearDocumentStyle();
626
627 /**
628 Clear all the registered images.
629 */
630 void ClearRegisteredImages();
631
632 /**
633 When key+modifier combination km is pressed perform msg.
634 */
635 void CmdKeyAssign(int key, int modifiers, int cmd);
636
637 /**
638 When key+modifier combination km is pressed do nothing.
639 */
640 void CmdKeyClear(int key, int modifiers);
641
642 /**
643 Drop all key mappings.
644 */
645 void CmdKeyClearAll();
646
647 /**
648 Perform one of the operations defined by the wxSTC_CMD_* constants.
649 */
650 void CmdKeyExecute(int cmd);
651
652 /**
653 Colourise a segment of the document using the current lexing language.
654 */
655 void Colourise(int start, int end);
656
657 /**
658 Convert all line endings in the document to one mode.
659 */
660 void ConvertEOLs(int eolMode);
661
662 /**
663 Copy the selection to the clipboard.
664 */
665 void Copy();
666
667 /**
668 Copy a range of text to the clipboard. Positions are clipped into the document.
669 */
670 void CopyRange(int start, int end);
671
672 /**
673 Copy argument text to the clipboard.
674 */
675 void CopyText(int length, const wxString& text);
676
677 /**
678
679 */
680 bool Create(wxWindow* parent, wxWindowID id = wxID_ANY,
681 const wxPoint& pos = wxDefaultPosition,
682 const wxSize& size = wxDefaultSize,
683 long style = 0,
684 const wxString& name = wxSTCNameStr);
685
686 /**
687 Create a new document object.
688 Starts with reference count of 1 and not selected into editor.
689 */
690 void* CreateDocument();
691
692 /**
693 Cut the selection to the clipboard.
694 */
4cc4bfaf 695 void Cut();
23324ae1
FM
696
697 /**
698 Delete back from the current position to the start of the line.
699 */
700 void DelLineLeft();
701
702 /**
703 Delete forwards from the current position to the end of the line.
704 */
705 void DelLineRight();
706
707 /**
708 Delete the word to the left of the caret.
709 */
710 void DelWordLeft();
711
712 /**
713 Delete the word to the right of the caret.
714 */
715 void DelWordRight();
716
717 /**
718 Delete the selection or if no selection, the character before the caret.
719 */
720 void DeleteBack();
721
722 /**
723 Delete the selection or if no selection, the character before the caret.
724 Will not delete the character before at the start of a line.
725 */
726 void DeleteBackNotLine();
727
728 /**
729 Allow for simulating a DnD DragOver
730 */
731 wxDragResult DoDragOver(wxCoord x, wxCoord y, wxDragResult def);
732
733 /**
734 Allow for simulating a DnD DropText
735 */
736 bool DoDropText(long x, long y, const wxString& data);
737
738 /**
739 Find the document line of a display line taking hidden lines into account.
740 */
741 int DocLineFromVisible(int lineDisplay);
742
743 /**
744 Move caret to last position in document.
745 */
746 void DocumentEnd();
747
748 /**
749 Move caret to last position in document extending selection to new caret
750 position.
751 */
752 void DocumentEndExtend();
753
754 /**
755 Move caret to first position in document.
756 */
757 void DocumentStart();
758
759 /**
760 Move caret to first position in document extending selection to new caret
761 position.
762 */
763 void DocumentStartExtend();
764
765 /**
766 Switch from insert to overtype mode or the reverse.
767 */
768 void EditToggleOvertype();
769
770 /**
771 Delete the undo history.
772 */
773 void EmptyUndoBuffer();
774
775 /**
776 End a sequence of actions that is undone and redone as a unit.
777 */
778 void EndUndoAction();
779
780 /**
781 Ensure the caret is visible.
782 */
783 void EnsureCaretVisible();
784
785 /**
786 Ensure a particular line is visible by expanding any header line hiding it.
787 */
788 void EnsureVisible(int line);
789
790 /**
791 Ensure a particular line is visible by expanding any header line hiding it.
792 Use the currently set visibility policy to determine which range to display.
793 */
794 void EnsureVisibleEnforcePolicy(int line);
795
796 /**
797 Find the position of a column on a line taking into account tabs and
798 multi-byte characters. If beyond end of line, return line end position.
799 */
800 int FindColumn(int line, int column);
801
802 /**
803 Find some text in the document.
804 */
805 int FindText(int minPos, int maxPos, const wxString& text,
806 int flags = 0);
807
808 /**
809 Insert a Form Feed character.
810 */
811 void FormFeed();
812
813 /**
814 On Windows, will draw the document into a display context such as a printer.
815 */
816 int FormatRange(bool doDraw, int startPos, int endPos,
817 wxDC* draw, wxDC* target,
818 wxRect renderRect,
819 wxRect pageRect);
820
821 /**
822 Returns the position of the opposite end of the selection to the caret.
823 */
824 int GetAnchor();
825
826 /**
827 Does a backspace pressed when caret is within indentation unindent?
828 */
829 bool GetBackSpaceUnIndents();
830
831 /**
832 Is drawing done first into a buffer or direct to the screen?
833 */
834 bool GetBufferedDraw();
835
836 /**
837 Get the foreground colour of the caret.
838 */
839 wxColour GetCaretForeground();
840
841 /**
842 Get the background alpha of the caret line.
843 */
844 int GetCaretLineBackAlpha();
845
846 /**
847 Get the colour of the background of the line containing the caret.
848 */
849 wxColour GetCaretLineBackground();
850
851 /**
852 Is the background of the line containing the caret in a different colour?
853 */
854 bool GetCaretLineVisible();
855
856 /**
857 Get the time in milliseconds that the caret is on and off.
858 */
859 int GetCaretPeriod();
860
861 /**
862 Can the caret preferred x position only be changed by explicit movement
863 commands?
864 */
865 bool GetCaretSticky();
866
867 /**
868 Returns the width of the insert mode caret.
869 */
870 int GetCaretWidth();
871
872 /**
873 Returns the character byte at the position.
874 */
875 int GetCharAt(int pos);
876
877 /**
878 Get the code page used to interpret the bytes of the document as characters.
879 */
880 int GetCodePage();
881
882 /**
883 Retrieve the column number of a position, taking tab width into account.
884 */
885 int GetColumn(int pos);
886
887 /**
888 Get the way control characters are displayed.
889 */
890 int GetControlCharSymbol();
891
892 /**
893
894 */
895 wxString GetCurLine(int* OUTPUT);
896
897 /**
898
899 */
900 wxCharBuffer GetCurLineRaw(int* OUTPUT);
901
902 /**
903 END of generated section
23324ae1
FM
904 Others...
905 Returns the line number of the line with the caret.
906 */
907 int GetCurrentLine();
908
909 /**
910 Returns the position of the caret.
911 */
912 int GetCurrentPos();
913
914 /**
915 Retrieve a pointer to the document object.
916 */
917 void* GetDocPointer();
918
919 /**
920 Retrieve the current end of line mode - one of CRLF, CR, or LF.
921 */
922 int GetEOLMode();
923
924 /**
925 Retrieve the colour used in edge indication.
926 */
927 wxColour GetEdgeColour();
928
929 /**
930 Retrieve the column number which text should be kept within.
931 */
932 int GetEdgeColumn();
933
934 /**
935 Retrieve the edge highlight mode.
936 */
937 int GetEdgeMode();
938
939 /**
940 Retrieve whether the maximum scroll position has the last
941 line at the bottom of the view.
942 */
943 bool GetEndAtLastLine();
944
945 /**
946 Retrieve the position of the last correctly styled character.
947 */
948 int GetEndStyled();
949
950 /**
951 Retrieve the display line at the top of the display.
952 */
953 int GetFirstVisibleLine();
954
955 /**
956 Is a header line expanded?
957 */
958 bool GetFoldExpanded(int line);
959
960 /**
961 Retrieve the fold level of a line.
962 */
963 int GetFoldLevel(int line);
964
965 /**
966 Find the parent line of a child line.
967 */
968 int GetFoldParent(int line);
969
970 /**
971 Get the highlighted indentation guide column.
972 */
973 int GetHighlightGuide();
974
975 /**
976 Retrieve indentation size.
977 */
978 int GetIndent();
979
980 /**
981 Are the indentation guides visible?
982 */
983 bool GetIndentationGuides();
984
985 /**
986 Find the last child line of a header line.
987 */
988 int GetLastChild(int line, int level);
989
990 /**
991 Can be used to prevent the EVT_CHAR handler from adding the char
992 */
993 bool GetLastKeydownProcessed();
994
995 /**
996 Retrieve the degree of caching of layout information.
997 */
998 int GetLayoutCache();
999
1000 /**
1001 Returns the number of characters in the document.
1002 */
1003 int GetLength();
1004
1005 /**
1006 Retrieve the lexing language of the document.
1007 */
1008 int GetLexer();
1009
1010 /**
1011 Retrieve the contents of a line.
1012 */
1013 wxString GetLine(int line);
1014
1015 /**
1016 Returns the number of lines in the document. There is always at least one.
1017 */
1018 int GetLineCount();
1019
1020 /**
1021 Get the position after the last visible characters on a line.
1022 */
1023 int GetLineEndPosition(int line);
1024
1025 /**
1026 Retrieve the position before the first non indentation character on a line.
1027 */
1028 int GetLineIndentPosition(int line);
1029
1030 /**
1031 Retrieve the number of columns that a line is indented.
1032 */
1033 int GetLineIndentation(int line);
1034
1035 /**
1036 Retrieve the contents of a line.
1037 */
1038 wxCharBuffer GetLineRaw(int line);
1039
1040 /**
1041 Retrieve the position of the end of the selection at the given line
1042 (INVALID_POSITION if no selection on this line).
1043 */
1044 int GetLineSelEndPosition(int line);
1045
1046 /**
1047 Retrieve the position of the start of the selection at the given line
1048 (INVALID_POSITION if no selection on this line).
1049 */
1050 int GetLineSelStartPosition(int line);
1051
1052 /**
1053 Retrieve the extra styling information for a line.
1054 */
1055 int GetLineState(int line);
1056
1057 /**
1058 Is a line visible?
1059 */
1060 bool GetLineVisible(int line);
1061
1062 /**
1063 Returns the size in pixels of the left margin.
1064 */
1065 int GetMarginLeft();
1066
1067 /**
1068 Retrieve the marker mask of a margin.
1069 */
1070 int GetMarginMask(int margin);
1071
1072 /**
1073 Returns the size in pixels of the right margin.
1074 */
1075 int GetMarginRight();
1076
1077 /**
1078 Retrieve the mouse click sensitivity of a margin.
1079 */
1080 bool GetMarginSensitive(int margin);
1081
1082 /**
1083 Retrieve the type of a margin.
1084 */
1085 int GetMarginType(int margin);
1086
1087 /**
1088 Retrieve the width of a margin in pixels.
1089 */
1090 int GetMarginWidth(int margin);
1091
1092 /**
1093 Retrieve the last line number that has line state.
1094 */
1095 int GetMaxLineState();
1096
1097 /**
1098 Get which document modification events are sent to the container.
1099 */
1100 int GetModEventMask();
1101
1102 /**
1103 Is the document different from when it was last saved?
1104 */
1105 bool GetModify();
1106
1107 /**
1108 Get whether mouse gets captured.
1109 */
1110 bool GetMouseDownCaptures();
1111
1112 /**
1113 Retrieve the time the mouse must sit still to generate a mouse dwell event.
1114 */
1115 int GetMouseDwellTime();
1116
1117 /**
1118 Returns @true if overtype mode is active otherwise @false is returned.
1119 */
1120 bool GetOvertype();
1121
1122 /**
1123 Get convert-on-paste setting
1124 */
1125 bool GetPasteConvertEndings();
1126
1127 /**
1128 Returns the print colour mode.
1129 */
1130 int GetPrintColourMode();
1131
1132 /**
1133 Returns the print magnification.
1134 */
1135 int GetPrintMagnification();
1136
1137 /**
1138 Is printing line wrapped?
1139 */
1140 int GetPrintWrapMode();
1141
1142 /**
1143 Retrieve a 'property' value previously set with SetProperty.
1144 */
1145 wxString GetProperty(const wxString& key);
1146
1147 /**
1148 Retrieve a 'property' value previously set with SetProperty,
1149 with '$()' variable replacement on returned buffer.
1150 */
1151 wxString GetPropertyExpanded(const wxString& key);
1152
1153 /**
1154 Retrieve a 'property' value previously set with SetProperty,
1155 interpreted as an int AFTER any '$()' variable replacement.
1156 */
1157 int GetPropertyInt(const wxString& key);
1158
1159 /**
1160 In read-only mode?
1161 */
1162 bool GetReadOnly();
1163
1164 /**
1165 Get cursor type.
1166 */
1167 int GetSTCCursor();
1168
1169 /**
1170 Get internal focus flag.
1171 */
1172 bool GetSTCFocus();
1173
1174 /**
1175 Retrieve the document width assumed for scrolling.
1176 */
1177 int GetScrollWidth();
1178
1179 /**
1180 Get the search flags used by SearchInTarget.
1181 */
1182 int GetSearchFlags();
1183
1184 /**
1185 Get the alpha of the selection.
1186 */
1187 int GetSelAlpha();
1188
1189 /**
1190 Retrieve the selected text.
1191 */
1192 wxString GetSelectedText();
1193
1194 /**
1195 Retrieve the selected text.
1196 */
1197 wxCharBuffer GetSelectedTextRaw();
1198
1199 /**
1200
1201 */
1202 void GetSelection(int* OUTPUT, int* OUTPUT);
1203
1204 /**
1205 Returns the position at the end of the selection.
1206 */
1207 int GetSelectionEnd();
1208
1209 /**
1210 Get the mode of the current selection.
1211 */
1212 int GetSelectionMode();
1213
1214 /**
1215 Returns the position at the start of the selection.
1216 */
1217 int GetSelectionStart();
1218
1219 /**
1220 Get error status.
1221 */
1222 int GetStatus();
1223
1224 /**
1225 Returns the style byte at the position.
1226 */
1227 int GetStyleAt(int pos);
1228
1229 /**
1230 Retrieve number of bits in style bytes used to hold the lexical state.
1231 */
1232 int GetStyleBits();
1233
1234 /**
1235 Retrieve the number of bits the current lexer needs for styling.
1236 */
1237 int GetStyleBitsNeeded();
1238
1239 /**
1240 Retrieve a buffer of cells.
1241 */
1242 wxMemoryBuffer GetStyledText(int startPos, int endPos);
1243
1244 /**
1245 Does a tab pressed when caret is within indentation indent?
1246 */
1247 bool GetTabIndents();
1248
1249 /**
1250 Retrieve the visible size of a tab.
1251 */
1252 int GetTabWidth();
1253
1254 /**
1255 Get the position that ends the target.
1256 */
1257 int GetTargetEnd();
1258
1259 /**
1260 Get the position that starts the target.
1261 */
1262 int GetTargetStart();
1263
1264 /**
1265 Retrieve all the text in the document.
1266 */
1267 wxString GetText();
1268
1269 /**
1270 Retrieve the number of characters in the document.
1271 */
1272 int GetTextLength();
1273
1274 /**
1275 Retrieve a range of text.
1276 */
1277 wxString GetTextRange(int startPos, int endPos);
1278
1279 /**
1280 Retrieve a range of text.
1281 */
1282 wxCharBuffer GetTextRangeRaw(int startPos, int endPos);
1283
1284 /**
1285 Retrieve all the text in the document.
1286 */
1287 wxCharBuffer GetTextRaw();
1288
1289 /**
1290 Is drawing done in two phases with backgrounds drawn before foregrounds?
1291 */
1292 bool GetTwoPhaseDraw();
1293
1294 /**
1295 Is undo history being collected?
1296 */
1297 bool GetUndoCollection();
1298
1299 /**
1300 Returns the current UseAntiAliasing setting.
1301 */
1302 bool GetUseAntiAliasing();
1303
1304 /**
1305 Is the horizontal scroll bar visible?
1306 */
1307 bool GetUseHorizontalScrollBar();
1308
1309 /**
1310 Retrieve whether tabs will be used in indentation.
1311 */
1312 bool GetUseTabs();
1313
1314 /**
1315 Is the vertical scroll bar visible?
1316 */
1317 bool GetUseVerticalScrollBar();
1318
1319 /**
1320 Are the end of line characters visible?
1321 */
1322 bool GetViewEOL();
1323
1324 /**
1325 Are white space characters currently visible?
1326 Returns one of SCWS_* constants.
1327 */
1328 int GetViewWhiteSpace();
1329
1330 /**
1331 Retrieve whether text is word wrapped.
1332 */
1333 int GetWrapMode();
1334
1335 /**
1336 Retrive the start indent for wrapped lines.
1337 */
1338 int GetWrapStartIndent();
1339
1340 /**
1341 Retrive the display mode of visual flags for wrapped lines.
1342 */
1343 int GetWrapVisualFlags();
1344
1345 /**
1346 Retrive the location of visual flags for wrapped lines.
1347 */
1348 int GetWrapVisualFlagsLocation();
1349
1350 /**
1351
1352 */
1353 int GetXOffset();
1354
1355 /**
1356 Retrieve the zoom level.
1357 */
1358 int GetZoom();
1359
1360 /**
1361 Set caret to start of a line and ensure it is visible.
1362 */
1363 void GotoLine(int line);
1364
1365 /**
1366 Set caret to a position and ensure it is visible.
1367 */
1368 void GotoPos(int pos);
1369
1370 /**
1371 Make a range of lines invisible.
1372 */
1373 void HideLines(int lineStart, int lineEnd);
1374
1375 /**
1376 Draw the selection in normal style or with selection highlighted.
1377 */
1378 void HideSelection(bool normal);
1379
1380 /**
1381 Move caret to first position on line.
1382 */
1383 void Home();
1384
1385 /**
1386 Move caret to first position on display line.
1387 */
1388 void HomeDisplay();
1389
1390 /**
1391 Move caret to first position on display line extending selection to
1392 new caret position.
1393 */
1394 void HomeDisplayExtend();
1395
1396 /**
1397 Move caret to first position on line extending selection to new caret position.
1398 */
1399 void HomeExtend();
1400
1401 /**
1402 Move caret to first position on line, extending rectangular selection to new
1403 caret position.
1404 */
1405 void HomeRectExtend();
1406
1407 /**
1408 These are like their namesakes Home(Extend)?, LineEnd(Extend)?, VCHome(Extend)?
1409 except they behave differently when word-wrap is enabled:
1410 They go first to the start / end of the display line, like (Home|LineEnd)Display
1411 The difference is that, the cursor is already at the point, it goes on to the
1412 start
1413 or end of the document line, as appropriate for (Home|LineEnd|VCHome)(Extend)?.
1414 */
1415 void HomeWrap();
1416
1417 /**
1418
1419 */
1420 void HomeWrapExtend();
1421
1422 /**
1423 Retrieve the foreground colour of an indicator.
1424 */
1425 wxColour IndicatorGetForeground(int indic);
1426
1427 /**
1428 Retrieve the style of an indicator.
1429 */
1430 int IndicatorGetStyle(int indic);
1431
1432 /**
1433 Set the foreground colour of an indicator.
1434 */
1435 void IndicatorSetForeground(int indic, const wxColour& fore);
1436
1437 /**
1438 Set an indicator to plain, squiggle or TT.
1439 */
1440 void IndicatorSetStyle(int indic, int style);
1441
1442 /**
1443 Insert string at a position.
1444 */
1445 void InsertText(int pos, const wxString& text);
1446
1447 /**
1448 Insert string at a position.
1449 */
1450 void InsertTextRaw(int pos, const char* text);
1451
1452 /**
1453 Copy the line containing the caret.
1454 */
1455 void LineCopy();
1456
1457 /**
1458 Cut the line containing the caret.
1459 */
1460 void LineCut();
1461
1462 /**
1463 Delete the line containing the caret.
1464 */
1465 void LineDelete();
1466
1467 /**
1468 Move caret down one line.
1469 */
1470 void LineDown();
1471
1472 /**
1473 Move caret down one line extending selection to new caret position.
1474 */
1475 void LineDownExtend();
1476
1477 /**
1478 Move caret down one line, extending rectangular selection to new caret position.
1479 */
1480 void LineDownRectExtend();
1481
1482 /**
1483 Duplicate the current line.
1484 */
1485 void LineDuplicate();
1486
1487 /**
1488 Move caret to last position on line.
1489 */
1490 void LineEnd();
1491
1492 /**
1493 Move caret to last position on display line.
1494 */
1495 void LineEndDisplay();
1496
1497 /**
1498 Move caret to last position on display line extending selection to new
1499 caret position.
1500 */
1501 void LineEndDisplayExtend();
1502
1503 /**
1504 Move caret to last position on line extending selection to new caret position.
1505 */
1506 void LineEndExtend();
1507
1508 /**
1509 Move caret to last position on line, extending rectangular selection to new
1510 caret position.
1511 */
1512 void LineEndRectExtend();
1513
1514 /**
1515
1516 */
1517 void LineEndWrap();
1518
1519 /**
1520
1521 */
1522 void LineEndWrapExtend();
1523
1524 /**
1525 Retrieve the line containing a position.
1526 */
1527 int LineFromPosition(int pos);
1528
1529 /**
1530 How many characters are on a line, not including end of line characters?
1531 */
1532 int LineLength(int line);
1533
1534 /**
1535 Scroll horizontally and vertically.
1536 */
1537 void LineScroll(int columns, int lines);
1538
1539 /**
1540 Scroll the document down, keeping the caret visible.
1541 */
1542 void LineScrollDown();
1543
1544 /**
1545 Scroll the document up, keeping the caret visible.
1546 */
1547 void LineScrollUp();
1548
1549 /**
1550 Switch the current line with the previous.
1551 */
1552 void LineTranspose();
1553
1554 /**
1555 Move caret up one line.
1556 */
1557 void LineUp();
1558
1559 /**
1560 Move caret up one line extending selection to new caret position.
1561 */
1562 void LineUpExtend();
1563
1564 /**
1565 Move caret up one line, extending rectangular selection to new caret position.
1566 */
1567 void LineUpRectExtend();
1568
1569 /**
1570 Join the lines in the target.
1571 */
1572 void LinesJoin();
1573
1574 /**
1575 Retrieves the number of lines completely visible.
1576 */
1577 int LinesOnScreen();
1578
1579 /**
1580 Split the lines in the target into lines that are less wide than pixelWidth
1581 where possible.
1582 */
1583 void LinesSplit(int pixelWidth);
1584
1585 /**
1586 Load the contents of filename into the editor
1587 */
1588 bool LoadFile(const wxString& filename);
1589
1590 /**
1591 Transform the selection to lower case.
1592 */
1593 void LowerCase();
1594
1595 /**
1596 Add a marker to a line, returning an ID which can be used to find or delete the
1597 marker.
1598 */
1599 int MarkerAdd(int line, int markerNumber);
1600
1601 /**
1602 Add a set of markers to a line.
1603 */
1604 void MarkerAddSet(int line, int set);
1605
1606 /**
1607 Set the symbol used for a particular marker number,
1608 and optionally the fore and background colours.
1609 */
1610 void MarkerDefine(int markerNumber, int markerSymbol,
1611 const wxColour& foreground = wxNullColour,
1612 const wxColour& background = wxNullColour);
1613
1614 /**
1615 Define a marker from a bitmap
1616 */
1617 void MarkerDefineBitmap(int markerNumber, const wxBitmap& bmp);
1618
1619 /**
1620 Delete a marker from a line.
1621 */
1622 void MarkerDelete(int line, int markerNumber);
1623
1624 /**
1625 Delete all markers with a particular number from all lines.
1626 */
1627 void MarkerDeleteAll(int markerNumber);
1628
1629 /**
1630 Delete a marker.
1631 */
1632 void MarkerDeleteHandle(int handle);
1633
1634 /**
1635 Get a bit mask of all the markers set on a line.
1636 */
1637 int MarkerGet(int line);
1638
1639 /**
1640 Retrieve the line number at which a particular marker is located.
1641 */
1642 int MarkerLineFromHandle(int handle);
1643
1644 /**
1645 Find the next line after lineStart that includes a marker in mask.
1646 */
1647 int MarkerNext(int lineStart, int markerMask);
1648
1649 /**
1650 Find the previous line before lineStart that includes a marker in mask.
1651 */
1652 int MarkerPrevious(int lineStart, int markerMask);
1653
1654 /**
1655 Set the alpha used for a marker that is drawn in the text area, not the margin.
1656 */
1657 void MarkerSetAlpha(int markerNumber, int alpha);
1658
1659 /**
1660 Set the background colour used for a particular marker number.
1661 */
1662 void MarkerSetBackground(int markerNumber, const wxColour& back);
1663
1664 /**
1665 Set the foreground colour used for a particular marker number.
1666 */
1667 void MarkerSetForeground(int markerNumber, const wxColour& fore);
1668
1669 /**
1670 Move the caret inside current view if it's not there already.
1671 */
1672 void MoveCaretInsideView();
1673
1674 /**
1675 Insert a new line, may use a CRLF, CR or LF depending on EOL mode.
1676 */
1677 void NewLine();
1678
1679 /**
1680 Move caret one page down.
1681 */
1682 void PageDown();
1683
1684 /**
1685 Move caret one page down extending selection to new caret position.
1686 */
1687 void PageDownExtend();
1688
1689 /**
1690 Move caret one page down, extending rectangular selection to new caret position.
1691 */
1692 void PageDownRectExtend();
1693
1694 /**
1695 Move caret one page up.
1696 */
1697 void PageUp();
1698
1699 /**
1700 Move caret one page up extending selection to new caret position.
1701 */
1702 void PageUpExtend();
1703
1704 /**
1705 Move caret one page up, extending rectangular selection to new caret position.
1706 */
1707 void PageUpRectExtend();
1708
1709 /**
1710 Move caret between paragraphs (delimited by empty lines).
1711 */
1712 void ParaDown();
1713
1714 /**
1715
1716 */
1717 void ParaDownExtend();
1718
1719 /**
1720
1721 */
1722 void ParaUp();
1723
1724 /**
1725
1726 */
1727 void ParaUpExtend();
1728
1729 /**
1730 Paste the contents of the clipboard into the document replacing the selection.
1731 */
1732 void Paste();
1733
1734 /**
1735 Retrieve the point in the window where a position is displayed.
1736 */
1737 wxPoint PointFromPosition(int pos);
1738
1739 /**
1740 Given a valid document position, return the next position taking code
1741 page into account. Maximum value returned is the last position in the document.
1742 */
1743 int PositionAfter(int pos);
1744
1745 /**
1746 Given a valid document position, return the previous position taking code
1747 page into account. Returns 0 if passed 0.
1748 */
1749 int PositionBefore(int pos);
1750
1751 /**
1752 Retrieve the position at the start of a line.
1753 */
1754 int PositionFromLine(int line);
1755
1756 /**
1757 Find the position from a point within the window.
1758 */
1759 int PositionFromPoint(wxPoint pt);
1760
1761 /**
1762 Find the position from a point within the window but return
1763 INVALID_POSITION if not close to text.
1764 */
1765 int PositionFromPointClose(int x, int y);
1766
1767 /**
1768 Redoes the next action on the undo history.
1769 */
1770 void Redo();
1771
1772 /**
1773 Register an image for use in autocompletion lists.
1774 */
1775 void RegisterImage(int type, const wxBitmap& bmp);
1776
1777 /**
1778 Release a reference to the document, deleting document if it fades to black.
1779 */
1780 void ReleaseDocument(void* docPointer);
1781
1782 /**
1783 Replace the selected text with the argument text.
1784 */
1785 void ReplaceSelection(const wxString& text);
1786
1787 /**
1788 Replace the target text with the argument text.
1789 Text is counted so it can contain NULs.
1790 Returns the length of the replacement text.
1791 */
1792 int ReplaceTarget(const wxString& text);
1793
1794 /**
7c913512 1795 Replace the target text with the argument text after
23324ae1
FM
1796 d processing.
1797 Text is counted so it can contain NULs.
7c913512 1798 Looks for
23324ae1 1799 d where d is between 1 and 9 and replaces these with the strings
7c913512
FM
1800 matched in the last search operation which were surrounded by
1801 ( and
23324ae1
FM
1802 ).
1803 Returns the length of the replacement text including any change
7c913512 1804 caused by processing the
23324ae1
FM
1805 d patterns.
1806 */
1807 int ReplaceTargetRE(const wxString& text);
1808
1809 /**
1810 Write the contents of the editor to filename
1811 */
1812 bool SaveFile(const wxString& filename);
1813
1814 /**
1815 Scroll enough to make the given column visible
1816 */
1817 void ScrollToColumn(int column);
1818
1819 /**
1820 Scroll enough to make the given line visible
1821 */
1822 void ScrollToLine(int line);
1823
1824 /**
1825 Sets the current caret position to be the search anchor.
1826 */
1827 void SearchAnchor();
1828
1829 /**
1830 Search for a counted string in the target and set the target to the found
1831 range. Text is counted so it can contain NULs.
1832 Returns length of range or -1 for failure in which case target is not moved.
1833 */
1834 int SearchInTarget(const wxString& text);
1835
1836 /**
1837 Find some text starting at the search anchor.
1838 Does not ensure the selection is visible.
1839 */
1840 int SearchNext(int flags, const wxString& text);
1841
1842 /**
1843 Find some text starting at the search anchor and moving backwards.
1844 Does not ensure the selection is visible.
1845 */
1846 int SearchPrev(int flags, const wxString& text);
1847
1848 /**
1849 Select all the text in the document.
1850 */
1851 void SelectAll();
1852
1853 /**
1854 Duplicate the selection. If selection empty duplicate the line containing the
1855 caret.
1856 */
1857 void SelectionDuplicate();
1858
1859 /**
1860 Is the selection rectangular? The alternative is the more common stream
1861 selection.
1862 */
1863 bool SelectionIsRectangle();
1864
1865 /**
1866 Send a message to Scintilla
1867 */
1868 long SendMsg(int msg, long wp = 0, long lp = 0);
1869
1870 /**
1871 Set the selection anchor to a position. The anchor is the opposite
1872 end of the selection from the caret.
1873 */
1874 void SetAnchor(int posAnchor);
1875
1876 /**
1877 Sets whether a backspace pressed when caret is within indentation unindents.
1878 */
1879 void SetBackSpaceUnIndents(bool bsUnIndents);
1880
1881 /**
1882 If drawing is buffered then each line of text is drawn into a bitmap buffer
1883 before drawing it to the screen to avoid flicker.
1884 */
1885 void SetBufferedDraw(bool buffered);
1886
1887 /**
1888 Set the foreground colour of the caret.
1889 */
1890 void SetCaretForeground(const wxColour& fore);
1891
1892 /**
1893 Set background alpha of the caret line.
1894 */
1895 void SetCaretLineBackAlpha(int alpha);
1896
1897 /**
1898 Set the colour of the background of the line containing the caret.
1899 */
1900 void SetCaretLineBackground(const wxColour& back);
1901
1902 /**
1903 Display the background of the line containing the caret in a different colour.
1904 */
1905 void SetCaretLineVisible(bool show);
1906
1907 /**
1908 Get the time in milliseconds that the caret is on and off. 0 = steady on.
1909 */
1910 void SetCaretPeriod(int periodMilliseconds);
1911
1912 /**
1913 Stop the caret preferred x position changing when the user types.
1914 */
1915 void SetCaretSticky(bool useCaretStickyBehaviour);
1916
1917 /**
1918 Set the width of the insert mode caret.
1919 */
1920 void SetCaretWidth(int pixelWidth);
1921
1922 /**
1923 Reset the set of characters for whitespace and word characters to the defaults.
1924 */
1925 void SetCharsDefault();
1926
1927 /**
1928 Set the code page used to interpret the bytes of the document as characters.
1929 */
1930 void SetCodePage(int codePage);
1931
1932 /**
1933 Change the way control characters are displayed:
1934 If symbol is 32, keep the drawn way, else, use the given character.
1935 */
1936 void SetControlCharSymbol(int symbol);
1937
1938 /**
1939 Sets the position of the caret.
1940 */
1941 void SetCurrentPos(int pos);
1942
1943 /**
1944 Change the document object used.
1945 */
1946 void SetDocPointer(void* docPointer);
1947
1948 /**
1949 Set the current end of line mode.
1950 */
1951 void SetEOLMode(int eolMode);
1952
1953 /**
1954 Change the colour used in edge indication.
1955 */
1956 void SetEdgeColour(const wxColour& edgeColour);
1957
1958 /**
1959 Set the column number of the edge.
1960 If text goes past the edge then it is highlighted.
1961 */
1962 void SetEdgeColumn(int column);
1963
1964 /**
1965 The edge may be displayed by a line (EDGE_LINE) or by highlighting text that
1966 goes beyond it (EDGE_BACKGROUND) or not displayed at all (EDGE_NONE).
1967 */
1968 void SetEdgeMode(int mode);
1969
1970 /**
1971 Sets the scroll range so that maximum scroll position has
1972 the last line at the bottom of the view (default).
1973 Setting this to @false allows scrolling one page below the last line.
1974 */
1975 void SetEndAtLastLine(bool endAtLastLine);
1976
1977 /**
1978 Show the children of a header line.
1979 */
1980 void SetFoldExpanded(int line, bool expanded);
1981
1982 /**
1983 Set some style options for folding.
1984 */
1985 void SetFoldFlags(int flags);
1986
1987 /**
1988 Set the fold level of a line.
1989 This encodes an integer level along with flags indicating whether the
1990 line is a header and whether it is effectively white space.
1991 */
1992 void SetFoldLevel(int line, int level);
1993
1994 /**
1995 Set the colours used as a chequerboard pattern in the fold margin
1996 */
1997 void SetFoldMarginColour(bool useSetting, const wxColour& back);
1998
1999 /**
2000
2001 */
2002 void SetFoldMarginHiColour(bool useSetting, const wxColour& fore);
2003
2004 /**
2005 Set the horizontal scrollbar to use instead of the ont that's built-in.
2006 */
2007 void SetHScrollBar(wxScrollBar* bar);
2008
2009 /**
2010 Set the highlighted indentation guide column.
2011 0 = no highlighted guide.
2012 */
2013 void SetHighlightGuide(int column);
2014
2015 /**
2016 Set a back colour for active hotspots.
2017 */
2018 void SetHotspotActiveBackground(bool useSetting,
2019 const wxColour& back);
2020
2021 /**
2022 Set a fore colour for active hotspots.
2023 */
2024 void SetHotspotActiveForeground(bool useSetting,
2025 const wxColour& fore);
2026
2027 /**
2028 Enable / Disable underlining active hotspots.
2029 */
2030 void SetHotspotActiveUnderline(bool underline);
2031
2032 /**
2033 Limit hotspots to single line so hotspots on two lines don't merge.
2034 */
2035 void SetHotspotSingleLine(bool singleLine);
2036
2037 /**
2038 Set the number of spaces used for one level of indentation.
2039 */
2040 void SetIndent(int indentSize);
2041
2042 /**
2043 Show or hide indentation guides.
2044 */
2045 void SetIndentationGuides(bool show);
2046
2047 /**
2048 Set up the key words used by the lexer.
2049 */
2050 void SetKeyWords(int keywordSet, const wxString& keyWords);
2051
2052 /**
2053
2054 */
2055 void SetLastKeydownProcessed(bool val);
2056
2057 /**
2058 Sets the degree of caching of layout information.
2059 */
2060 void SetLayoutCache(int mode);
2061
2062 /**
2063 Set the lexing language of the document.
2064 */
2065 void SetLexer(int lexer);
2066
2067 /**
2068 Set the lexing language of the document based on string name.
2069 */
2070 void SetLexerLanguage(const wxString& language);
2071
2072 /**
2073 Change the indentation of a line to a number of columns.
2074 */
2075 void SetLineIndentation(int line, int indentSize);
2076
2077 /**
2078 Used to hold extra styling information for each line.
2079 */
2080 void SetLineState(int line, int state);
2081
2082 /**
2083 Sets the size in pixels of the left margin.
2084 */
2085 void SetMarginLeft(int pixelWidth);
2086
2087 /**
2088 Set a mask that determines which markers are displayed in a margin.
2089 */
2090 void SetMarginMask(int margin, int mask);
2091
2092 /**
2093 Sets the size in pixels of the right margin.
2094 */
2095 void SetMarginRight(int pixelWidth);
2096
2097 /**
2098 Make a margin sensitive or insensitive to mouse clicks.
2099 */
2100 void SetMarginSensitive(int margin, bool sensitive);
2101
2102 /**
2103 Set a margin to be either numeric or symbolic.
2104 */
2105 void SetMarginType(int margin, int marginType);
2106
2107 /**
2108 Set the width of a margin to a width expressed in pixels.
2109 */
2110 void SetMarginWidth(int margin, int pixelWidth);
2111
2112 /**
2113 Set the left and right margin in the edit area, measured in pixels.
2114 */
2115 void SetMargins(int left, int right);
2116
2117 /**
2118 Set which document modification events are sent to the container.
2119 */
2120 void SetModEventMask(int mask);
2121
2122 /**
2123 Set whether the mouse is captured when its button is pressed.
2124 */
2125 void SetMouseDownCaptures(bool captures);
2126
2127 /**
2128 Sets the time the mouse must sit still to generate a mouse dwell event.
2129 */
2130 void SetMouseDwellTime(int periodMilliseconds);
2131
2132 /**
2133 Set to overtype (@true) or insert mode.
2134 */
2135 void SetOvertype(bool overtype);
2136
2137 /**
2138 Enable/Disable convert-on-paste for line endings
2139 */
2140 void SetPasteConvertEndings(bool convert);
2141
2142 /**
2143 Modify colours when printing for clearer printed text.
2144 */
2145 void SetPrintColourMode(int mode);
2146
2147 /**
2148 Sets the print magnification added to the point size of each style for printing.
2149 */
2150 void SetPrintMagnification(int magnification);
2151
2152 /**
2153 Set printing to line wrapped (SC_WRAP_WORD) or not line wrapped (SC_WRAP_NONE).
2154 */
2155 void SetPrintWrapMode(int mode);
2156
2157 /**
2158 Set up a value that may be used by a lexer for some optional feature.
2159 */
2160 void SetProperty(const wxString& key, const wxString& value);
2161
2162 /**
2163 Set to read only or read write.
2164 */
2165 void SetReadOnly(bool readOnly);
2166
2167 /**
2168 Sets the cursor to one of the SC_CURSOR* values.
2169 */
2170 void SetSTCCursor(int cursorType);
2171
2172 /**
2173 Change internal focus flag.
2174 */
2175 void SetSTCFocus(bool focus);
2176
2177 /**
2178 Remember the current position in the undo history as the position
2179 at which the document was saved.
2180 */
2181 void SetSavePoint();
2182
2183 /**
2184 Sets the document width assumed for scrolling.
2185 */
2186 void SetScrollWidth(int pixelWidth);
2187
2188 /**
2189 Set the search flags used by SearchInTarget.
2190 */
2191 void SetSearchFlags(int flags);
2192
2193 /**
2194 Set the alpha of the selection.
2195 */
2196 void SetSelAlpha(int alpha);
2197
2198 /**
2199 Set the background colour of the selection and whether to use this setting.
2200 */
2201 void SetSelBackground(bool useSetting, const wxColour& back);
2202
2203 /**
2204 Set the foreground colour of the selection and whether to use this setting.
2205 */
2206 void SetSelForeground(bool useSetting, const wxColour& fore);
2207
2208 /**
2209 Select a range of text.
2210 */
2211 void SetSelection(int start, int end);
2212
2213 /**
2214 Sets the position that ends the selection - this becomes the currentPosition.
2215 */
2216 void SetSelectionEnd(int pos);
2217
2218 /**
2219 Set the selection mode to stream (SC_SEL_STREAM) or rectangular
2220 (SC_SEL_RECTANGLE) or
2221 by lines (SC_SEL_LINES).
2222 */
2223 void SetSelectionMode(int mode);
2224
2225 /**
2226 Sets the position that starts the selection - this becomes the anchor.
2227 */
2228 void SetSelectionStart(int pos);
2229
2230 /**
2231 Change error status - 0 = OK.
2232 */
2233 void SetStatus(int statusCode);
2234
2235 /**
2236 Divide each styling byte into lexical class bits (default: 5) and indicator
2237 bits (default: 3). If a lexer requires more than 32 lexical states, then this
2238 is used to expand the possible states.
2239 */
2240 void SetStyleBits(int bits);
2241
2242 /**
2243 Set the styles for a segment of the document.
2244 */
2245 void SetStyleBytes(int length, char* styleBytes);
2246
2247 /**
2248 Change style from current styling position for length characters to a style
2249 and move the current styling position to after this newly styled segment.
2250 */
2251 void SetStyling(int length, int style);
2252
2253 /**
2254 Sets whether a tab pressed when caret is within indentation indents.
2255 */
2256 void SetTabIndents(bool tabIndents);
2257
2258 /**
2259 Change the visible size of a tab to be a multiple of the width of a space
2260 character.
2261 */
2262 void SetTabWidth(int tabWidth);
2263
2264 /**
2265 Sets the position that ends the target which is used for updating the
2266 document without affecting the scroll position.
2267 */
2268 void SetTargetEnd(int pos);
2269
2270 /**
2271 Sets the position that starts the target which is used for updating the
2272 document without affecting the scroll position.
2273 */
2274 void SetTargetStart(int pos);
2275
2276 /**
2277 Replace the contents of the document with the argument text.
2278 */
2279 void SetText(const wxString& text);
2280
2281 /**
2282 Replace the contents of the document with the argument text.
2283 */
2284 void SetTextRaw(const char* text);
2285
2286 /**
2287 In twoPhaseDraw mode, drawing is performed in two phases, first the background
2288 and then the foreground. This avoids chopping off characters that overlap the
2289 next run.
2290 */
2291 void SetTwoPhaseDraw(bool twoPhase);
2292
2293 /**
2294 Choose between collecting actions into the undo
2295 history and discarding them.
2296 */
2297 void SetUndoCollection(bool collectUndo);
2298
2299 /**
2300 Specify whether anti-aliased fonts should be used. Will have no effect
2301 on some platforms, but on some (wxMac for example) can greatly improve
2302 performance.
2303 */
2304 void SetUseAntiAliasing(bool useAA);
2305
2306 /**
2307 Show or hide the horizontal scroll bar.
2308 */
2309 void SetUseHorizontalScrollBar(bool show);
2310
2311 /**
2312 Indentation will only use space characters if useTabs is @false, otherwise
2313 it will use a combination of tabs and spaces.
2314 */
2315 void SetUseTabs(bool useTabs);
2316
2317 /**
2318 Show or hide the vertical scroll bar.
2319 */
2320 void SetUseVerticalScrollBar(bool show);
2321
2322 /**
2323 Set the vertical scrollbar to use instead of the ont that's built-in.
2324 */
2325 void SetVScrollBar(wxScrollBar* bar);
2326
2327 /**
2328 Make the end of line characters visible or invisible.
2329 */
2330 void SetViewEOL(bool visible);
2331
2332 /**
2333 Make white space characters invisible, always visible or visible outside
2334 indentation.
2335 */
2336 void SetViewWhiteSpace(int viewWS);
2337
2338 /**
2339 Set the way the display area is determined when a particular line
2340 is to be moved to by Find, FindNext, GotoLine, etc.
2341 */
2342 void SetVisiblePolicy(int visiblePolicy, int visibleSlop);
2343
2344 /**
2345 Set the background colour of all whitespace and whether to use this setting.
2346 */
2347 void SetWhitespaceBackground(bool useSetting,
2348 const wxColour& back);
2349
2350 /**
2351 Set the set of characters making up whitespace for when moving or selecting by
2352 word.
2353 Should be called after SetWordChars.
2354 */
2355 void SetWhitespaceChars(const wxString& characters);
2356
2357 /**
2358 Set the foreground colour of all whitespace and whether to use this setting.
2359 */
2360 void SetWhitespaceForeground(bool useSetting,
2361 const wxColour& fore);
2362
2363 /**
2364 Set the set of characters making up words for when moving or selecting by word.
2365 First sets deaults like SetCharsDefault.
2366 */
2367 void SetWordChars(const wxString& characters);
2368
2369 /**
2370 Sets whether text is word wrapped.
2371 */
2372 void SetWrapMode(int mode);
2373
2374 /**
2375 Set the start indent for wrapped lines.
2376 */
2377 void SetWrapStartIndent(int indent);
2378
2379 /**
2380 Set the display mode of visual flags for wrapped lines.
2381 */
2382 void SetWrapVisualFlags(int wrapVisualFlags);
2383
2384 /**
2385 Set the location of visual flags for wrapped lines.
2386 */
2387 void SetWrapVisualFlagsLocation(int wrapVisualFlagsLocation);
2388
2389 /**
2390 Set the way the caret is kept visible when going sideway.
2391 The exclusion zone is given in pixels.
2392 */
2393 void SetXCaretPolicy(int caretPolicy, int caretSlop);
2394
2395 /**
2396 Get and Set the xOffset (ie, horizonal scroll position).
2397 */
2398 void SetXOffset(int newOffset);
2399
2400 /**
2401 Set the way the line the caret is on is kept visible.
2402 The exclusion zone is given in lines.
2403 */
2404 void SetYCaretPolicy(int caretPolicy, int caretSlop);
2405
2406 /**
2407 Set the zoom level. This number of points is added to the size of all fonts.
2408 It may be positive to magnify or negative to reduce.
2409 */
2410 void SetZoom(int zoom);
2411
2412 /**
2413 Make a range of lines visible.
2414 */
2415 void ShowLines(int lineStart, int lineEnd);
2416
2417 /**
2418 Start notifying the container of all key presses and commands.
2419 */
2420 void StartRecord();
2421
2422 /**
2423 Set the current styling position to pos and the styling mask to mask.
2424 The styling mask can be used to protect some bits in each styling byte from
2425 modification.
2426 */
2427 void StartStyling(int pos, int mask);
2428
2429 /**
2430 Stop notifying the container of all key presses and commands.
2431 */
2432 void StopRecord();
2433
2434 /**
2435 Move caret to bottom of page, or one page down if already at bottom of page.
2436 */
2437 void StutteredPageDown();
2438
2439 /**
2440 Move caret to bottom of page, or one page down if already at bottom of page,
2441 extending selection to new caret position.
2442 */
2443 void StutteredPageDownExtend();
2444
2445 /**
2446 Move caret to top of page, or one page up if already at top of page.
2447 */
2448 void StutteredPageUp();
2449
2450 /**
2451 Move caret to top of page, or one page up if already at top of page, extending
2452 selection to new caret position.
2453 */
2454 void StutteredPageUpExtend();
2455
2456 /**
2457 Clear all the styles and make equivalent to the global default style.
2458 */
2459 void StyleClearAll();
2460
2461 /**
2462 Reset the default style to its state at startup
2463 */
2464 void StyleResetDefault();
2465
2466 /**
2467 Set the background colour of a style.
2468 */
2469 void StyleSetBackground(int style, const wxColour& back);
2470
2471 /**
2472 Set a style to be bold or not.
2473 */
2474 void StyleSetBold(int style, bool bold);
2475
2476 /**
2477 Set a style to be mixed case, or to force upper or lower case.
2478 */
2479 void StyleSetCase(int style, int caseForce);
2480
2481 /**
2482 Set a style to be changeable or not (read only).
2483 Experimental feature, currently buggy.
2484 */
2485 void StyleSetChangeable(int style, bool changeable);
2486
2487 /**
2488 Set the character set of the font in a style. Converts the Scintilla
2489 character set values to a wxFontEncoding.
2490 */
2491 void StyleSetCharacterSet(int style, int characterSet);
2492
2493 /**
2494 Set a style to have its end of line filled or not.
2495 */
2496 void StyleSetEOLFilled(int style, bool filled);
2497
2498 /**
2499 Set the font of a style.
2500 */
2501 void StyleSetFaceName(int style, const wxString& fontName);
2502
2503 /**
2504 Set style size, face, bold, italic, and underline attributes from
2505 a wxFont's attributes.
2506 */
2507 void StyleSetFont(int styleNum, wxFont& font);
2508
2509 /**
2510 Set all font style attributes at once.
2511 */
2512 void StyleSetFontAttr(int styleNum, int size,
2513 const wxString& faceName,
2514 bool bold,
2515 bool italic,
2516 bool underline,
2517 wxFontEncoding encoding = wxFONTENCODING_DEFAULT);
2518
2519 /**
2520 Set the font encoding to be used by a style.
2521 */
2522 void StyleSetFontEncoding(int style, wxFontEncoding encoding);
2523
2524 /**
2525 Set the foreground colour of a style.
2526 */
2527 void StyleSetForeground(int style, const wxColour& fore);
2528
2529 /**
2530 Set a style to be a hotspot or not.
2531 */
2532 void StyleSetHotSpot(int style, bool hotspot);
2533
2534 /**
2535 Set a style to be italic or not.
2536 */
2537 void StyleSetItalic(int style, bool italic);
2538
2539 /**
2540 Set the size of characters of a style.
2541 */
2542 void StyleSetSize(int style, int sizePoints);
2543
2544 /**
2545 Extract style settings from a spec-string which is composed of one or
2546 more of the following comma separated elements:
2547 bold turns on bold
2548 italic turns on italics
2549 fore:[name or #RRGGBB] sets the foreground colour
2550 back:[name or #RRGGBB] sets the background colour
2551 face:[facename] sets the font face name to use
2552 size:[num] sets the font size in points
2553 eol turns on eol filling
2554 underline turns on underlining
2555 */
2556 void StyleSetSpec(int styleNum, const wxString& spec);
2557
2558 /**
2559 Set a style to be underlined or not.
2560 */
2561 void StyleSetUnderline(int style, bool underline);
2562
2563 /**
2564 Set a style to be visible or not.
2565 */
2566 void StyleSetVisible(int style, bool visible);
2567
2568 /**
2569 If selection is empty or all on one line replace the selection with a tab
2570 character.
2571 If more than one line selected, indent the lines.
2572 */
4cc4bfaf 2573 void Tab();
23324ae1
FM
2574
2575 /**
2576 Make the target range start and end be the same as the selection range start
2577 and end.
2578 */
2579 void TargetFromSelection();
2580
2581 /**
2582 Retrieve the height of a particular line of text in pixels.
2583 */
2584 int TextHeight(int line);
2585
2586 /**
2587 Measure the pixel width of some text in a particular style.
2588 NUL terminated text argument.
2589 Does not handle tab or control characters.
2590 */
2591 int TextWidth(int style, const wxString& text);
2592
2593 /**
2594 Switch between sticky and non-sticky: meant to be bound to a key.
2595 */
2596 void ToggleCaretSticky();
2597
2598 /**
2599 Switch a header line between expanded and contracted.
2600 */
2601 void ToggleFold(int line);
2602
2603 /**
2604 Undo one action in the undo history.
2605 */
2606 void Undo();
2607
2608 /**
2609 Transform the selection to upper case.
2610 */
2611 void UpperCase();
2612
2613 /**
2614 Set whether a pop up menu is displayed automatically when the user presses
2615 the wrong mouse button.
2616 */
2617 void UsePopUp(bool allowPopUp);
2618
2619 /**
2620 Display a list of strings and send notification when user chooses one.
2621 */
2622 void UserListShow(int listType, const wxString& itemList);
2623
2624 /**
2625 Move caret to before first visible character on line.
2626 If already there move to first character on line.
2627 */
2628 void VCHome();
2629
2630 /**
2631 Like VCHome but extending selection to new caret position.
2632 */
2633 void VCHomeExtend();
2634
2635 /**
2636 Move caret to before first visible character on line.
2637 If already there move to first character on line.
2638 In either case, extend rectangular selection to new caret position.
2639 */
2640 void VCHomeRectExtend();
2641
2642 /**
2643
2644 */
2645 void VCHomeWrap();
2646
2647 /**
2648
2649 */
2650 void VCHomeWrapExtend();
2651
2652 /**
2653 Find the display line of a document line taking hidden lines into account.
2654 */
2655 int VisibleFromDocLine(int line);
2656
2657 /**
2658 Get position of end of word.
2659 */
2660 int WordEndPosition(int pos, bool onlyWordCharacters);
2661
2662 /**
2663 Move caret left one word.
2664 */
2665 void WordLeft();
2666
2667 /**
2668 Move caret left one word, position cursor at end of word.
2669 */
2670 void WordLeftEnd();
2671
2672 /**
2673 Move caret left one word, position cursor at end of word, extending selection
2674 to new caret position.
2675 */
2676 void WordLeftEndExtend();
2677
2678 /**
2679 Move caret left one word extending selection to new caret position.
2680 */
2681 void WordLeftExtend();
2682
2683 /**
2684 Move to the previous change in capitalisation.
2685 */
2686 void WordPartLeft();
2687
2688 /**
2689 Move to the previous change in capitalisation extending selection
2690 to new caret position.
2691 */
2692 void WordPartLeftExtend();
2693
2694 /**
2695 Move to the change next in capitalisation.
2696 */
2697 void WordPartRight();
2698
2699 /**
2700 Move to the next change in capitalisation extending selection
2701 to new caret position.
2702 */
2703 void WordPartRightExtend();
2704
2705 /**
2706 Move caret right one word.
2707 */
2708 void WordRight();
2709
2710 /**
2711 Move caret right one word, position cursor at end of word.
2712 */
2713 void WordRightEnd();
2714
2715 /**
2716 Move caret right one word, position cursor at end of word, extending selection
2717 to new caret position.
2718 */
2719 void WordRightEndExtend();
2720
2721 /**
2722 Move caret right one word extending selection to new caret position.
2723 */
2724 void WordRightExtend();
2725
2726 /**
2727 Get position of start of word.
2728 */
2729 int WordStartPosition(int pos, bool onlyWordCharacters);
2730
2731 /**
2732 The number of display lines needed to wrap a document line
2733 */
2734 int WrapCount(int line);
2735
2736 /**
2737 Magnify the displayed text by increasing the sizes by 1 point.
2738 */
2739 void ZoomIn();
2740
2741 /**
2742 Make the displayed text smaller by decreasing the sizes by 1 point.
2743 */
2744 void ZoomOut();
2745};
e54c96f1 2746