ntdll: Added Urals time.
[wine] / dlls / riched20 / editor.h
1 /*
2  * RichEdit - prototypes for functions and macro definitions
3  *
4  * Copyright 2004 by Krzysztof Foltman
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19  */
20
21 #include "editstr.h"
22
23 #define ALLOC_OBJ(type) HeapAlloc(me_heap, 0, sizeof(type))
24 #define ALLOC_N_OBJ(type, count) HeapAlloc(me_heap, 0, (count)*sizeof(type))
25 #define FREE_OBJ(ptr) HeapFree(me_heap, 0, ptr)
26
27 #define RUN_IS_HIDDEN(run) ((run)->style->fmt.dwMask & CFM_HIDDEN \
28                              && (run)->style->fmt.dwEffects & CFE_HIDDEN)
29
30 /* style.c */
31 ME_Style *ME_MakeStyle(CHARFORMAT2W *style);
32 void ME_AddRefStyle(ME_Style *item);
33 void ME_ReleaseStyle(ME_Style *item);
34 ME_Style *ME_GetInsertStyle(ME_TextEditor *editor, int nCursor);
35 ME_Style *ME_ApplyStyle(ME_Style *sSrc, CHARFORMAT2W *style);
36 HFONT ME_SelectStyleFont(ME_TextEditor *editor, HDC hDC, ME_Style *s);
37 void ME_UnselectStyleFont(ME_TextEditor *editor, HDC hDC, ME_Style *s, HFONT hOldFont);
38 void ME_InitCharFormat2W(CHARFORMAT2W *pFmt);
39 void ME_SaveTempStyle(ME_TextEditor *editor);
40 void ME_ClearTempStyle(ME_TextEditor *editor);
41 void ME_DumpStyleToBuf(CHARFORMAT2W *pFmt, char buf[2048]);
42 void ME_DumpStyle(ME_Style *s);
43 CHARFORMAT2W *ME_ToCF2W(CHARFORMAT2W *to, CHARFORMAT2W *from);
44 void ME_CopyToCF2W(CHARFORMAT2W *to, CHARFORMAT2W *from);
45 CHARFORMAT2W *ME_ToCFAny(CHARFORMAT2W *to, CHARFORMAT2W *from);
46 void ME_CopyToCFAny(CHARFORMAT2W *to, CHARFORMAT2W *from);
47 void ME_CopyCharFormat(CHARFORMAT2W *pDest, CHARFORMAT2W *pSrc); /* only works with 2W structs */
48
49 /* list.c */
50 void ME_InsertBefore(ME_DisplayItem *diWhere, ME_DisplayItem *diWhat);
51 void ME_Remove(ME_DisplayItem *diWhere);
52 ME_DisplayItem *ME_FindItemBack(ME_DisplayItem *di, ME_DIType nTypeOrClass);
53 ME_DisplayItem *ME_FindItemFwd(ME_DisplayItem *di, ME_DIType nTypeOrClass);
54 ME_DisplayItem *ME_FindItemBackOrHere(ME_DisplayItem *di, ME_DIType nTypeOrClass);
55 ME_DisplayItem *ME_FindItemFwdOrHere(ME_DisplayItem *di, ME_DIType nTypeOrClass);
56 BOOL ME_DITypesEqual(ME_DIType type, ME_DIType nTypeOrClass);
57 ME_DisplayItem *ME_MakeDI(ME_DIType type);
58 void ME_DestroyDisplayItem(ME_DisplayItem *item);
59 void ME_DestroyTableCellList(ME_DisplayItem *item);
60 void ME_DumpDocument(ME_TextBuffer *buffer);
61 const char *ME_GetDITypeName(ME_DIType type);
62
63 /* string.c */
64 int ME_GetOptimalBuffer(int nLen);
65 ME_String *ME_MakeString(LPCWSTR szText);
66 ME_String *ME_MakeStringN(LPCWSTR szText, int nMaxChars);
67 ME_String *ME_StrDup(ME_String *s);
68 void ME_DestroyString(ME_String *s);
69 void ME_AppendString(ME_String *s1, ME_String *s2);
70 ME_String *ME_ConcatString(ME_String *s1, ME_String *s2);
71 ME_String *ME_VSplitString(ME_String *orig, int nVPos);
72 int ME_IsWhitespaces(ME_String *s);
73 int ME_IsSplitable(ME_String *s);
74 /* int ME_CalcSkipChars(ME_String *s); */
75 int ME_StrLen(ME_String *s);
76 int ME_StrVLen(ME_String *s);
77 int ME_FindNonWhitespaceV(ME_String *s, int nVChar);
78 int ME_FindWhitespaceV(ME_String *s, int nVChar);
79 int ME_CallWordBreakProc(ME_TextEditor *editor, ME_String *str, INT start, INT code);
80 int ME_GetCharFwd(ME_String *s, int nPos); /* get char starting from start */
81 int ME_GetCharBack(ME_String *s, int nPos); /* get char starting from \0  */
82 int ME_StrRelPos(ME_String *s, int nVChar, int *pRelChars);
83 int ME_StrRelPos2(ME_String *s, int nVChar, int nRelChars);
84 int ME_VPosToPos(ME_String *s, int nVPos);
85 int ME_PosToVPos(ME_String *s, int nPos);
86 void ME_StrDeleteV(ME_String *s, int nVChar, int nChars);
87 /* smart helpers for A<->W conversions, they reserve/free memory and call MultiByte<->WideChar functions */
88 LPWSTR ME_ToUnicode(HWND hWnd, LPVOID psz);
89 void ME_EndToUnicode(HWND hWnd, LPVOID psz);
90 LPSTR ME_ToAnsi(HWND hWnd, LPVOID psz);
91 void ME_EndToAnsi(HWND hWnd, LPVOID psz);
92
93 static inline int ME_IsWSpace(WCHAR ch)
94 {
95   return ch > '\0' && ch <= ' ';
96 }
97
98 /* note: those two really return the first matching offset (starting from EOS)+1 
99  * in other words, an offset of the first trailing white/black */
100 int ME_ReverseFindNonWhitespaceV(ME_String *s, int nVChar);
101 int ME_ReverseFindWhitespaceV(ME_String *s, int nVChar);
102
103 /* row.c */
104 ME_DisplayItem *ME_FindRowStart(ME_Context *c, ME_DisplayItem *run, int nRelPos);
105 ME_DisplayItem *ME_RowStart(ME_DisplayItem *item);
106 /* ME_DisplayItem *ME_RowEnd(ME_DisplayItem *item); */
107 void ME_RenumberParagraphs(ME_DisplayItem *item); /* TODO */
108 ME_DisplayItem *ME_FindRowWithNumber(ME_TextEditor *editor, int nRow);
109 int ME_RowNumberFromCharOfs(ME_TextEditor *editor, int nOfs);
110
111 /* run.c */
112 ME_DisplayItem *ME_MakeRun(ME_Style *s, ME_String *strData, int nFlags);
113 /* note: ME_InsertRun inserts a copy of the specified run - so you need to destroy the original */
114 ME_DisplayItem *ME_InsertRun(ME_TextEditor *editor, int nCharOfs, ME_DisplayItem *pItem);
115 ME_DisplayItem *ME_InsertRunAtCursor(ME_TextEditor *editor, ME_Cursor *cursor,
116                                      ME_Style *style, const WCHAR *str, int len, int flags);
117 void ME_CheckCharOffsets(ME_TextEditor *editor);
118 void ME_PropagateCharOffset(ME_DisplayItem *p, int shift);
119 void ME_GetGraphicsSize(ME_TextEditor *editor, ME_Run *run, SIZE *pSize);
120 int ME_CharFromPoint(ME_TextEditor *editor, int cx, ME_Run *run);
121 /* this one accounts for 1/2 char tolerance */
122 int ME_CharFromPointCursor(ME_TextEditor *editor, int cx, ME_Run *run);
123 int ME_PointFromChar(ME_TextEditor *editor, ME_Run *pRun, int nOffset);
124 int ME_GetLastSplittablePlace(ME_Context *c, ME_Run *run);
125 int ME_CanJoinRuns(ME_Run *run1, ME_Run *run2);
126 void ME_JoinRuns(ME_TextEditor *editor, ME_DisplayItem *p);
127 ME_DisplayItem *ME_SplitRun(ME_Context *c, ME_DisplayItem *item, int nChar);
128 ME_DisplayItem *ME_SplitRunSimple(ME_TextEditor *editor, ME_DisplayItem *item, int nChar);
129 int ME_FindSplitPoint(ME_Context *c, POINT *pt, ME_Run *run, int desperate);
130 void ME_UpdateRunFlags(ME_TextEditor *editor, ME_Run *run);
131 ME_DisplayItem *ME_SplitFurther(ME_TextEditor *editor, ME_DisplayItem *run);
132 void ME_CalcRunExtent(ME_Context *c, ME_Paragraph *para, ME_Run *run);
133 SIZE ME_GetRunSize(ME_Context *c, ME_Paragraph *para, ME_Run *run, int nLen);
134 void ME_CursorFromCharOfs(ME_TextEditor *editor, int nCharOfs, ME_Cursor *pCursor);
135 void ME_RunOfsFromCharOfs(ME_TextEditor *editor, int nCharOfs, ME_DisplayItem **ppRun, int *pOfs);
136 int ME_CharOfsFromRunOfs(ME_TextEditor *editor, ME_DisplayItem *pRun, int nOfs);
137 void ME_SkipAndPropagateCharOffset(ME_DisplayItem *p, int shift);
138 void ME_SetCharFormat(ME_TextEditor *editor, int nFrom, int nLen, CHARFORMAT2W *pFmt);
139 void ME_SetSelectionCharFormat(ME_TextEditor *editor, CHARFORMAT2W *pFmt);
140 void ME_GetCharFormat(ME_TextEditor *editor, int nFrom, int nLen, CHARFORMAT2W *pFmt);
141 void ME_GetSelectionCharFormat(ME_TextEditor *editor, CHARFORMAT2W *pFmt);
142 void ME_GetDefaultCharFormat(ME_TextEditor *editor, CHARFORMAT2W *pFmt);
143 void ME_SetDefaultCharFormat(ME_TextEditor *editor, CHARFORMAT2W *mod);
144
145 /* caret.c */
146 void ME_SetSelection(ME_TextEditor *editor, int from, int to);
147 void ME_SelectWord(ME_TextEditor *editor);
148 void ME_HideCaret(ME_TextEditor *ed);
149 void ME_ShowCaret(ME_TextEditor *ed);
150 void ME_MoveCaret(ME_TextEditor *ed);
151 int ME_FindPixelPos(ME_TextEditor *editor, int x, int y, ME_Cursor *result, BOOL *is_eol);
152 int ME_CharFromPos(ME_TextEditor *editor, int x, int y);
153 void ME_LButtonDown(ME_TextEditor *editor, int x, int y);
154 void ME_MouseMove(ME_TextEditor *editor, int x, int y);
155 void ME_DeleteTextAtCursor(ME_TextEditor *editor, int nCursor, int nChars);
156 void ME_InsertTextFromCursor(ME_TextEditor *editor, int nCursor, 
157                              const WCHAR *str, int len, ME_Style *style);
158 void ME_SetCharFormat(ME_TextEditor *editor, int nOfs, int nChars, CHARFORMAT2W *pFmt);
159 BOOL ME_ArrowKey(ME_TextEditor *ed, int nVKey, BOOL extend, BOOL ctrl);
160
161 void ME_InitContext(ME_Context *c, ME_TextEditor *editor, HDC hDC);
162 void ME_DestroyContext(ME_Context *c);
163 ME_Style *GetInsertStyle(ME_TextEditor *editor, int nCursor);
164 void ME_MustBeWrapped(ME_Context *c, ME_DisplayItem *para);
165 void ME_GetCursorCoordinates(ME_TextEditor *editor, ME_Cursor *pCursor,
166                              int *x, int *y, int *height);
167 int ME_GetCursorOfs(ME_TextEditor *editor, int nCursor);
168 void ME_GetSelection(ME_TextEditor *editor, int *from, int *to);
169 int ME_CountParagraphsBetween(ME_TextEditor *editor, int from, int to);
170 BOOL ME_IsSelection(ME_TextEditor *editor);
171 void ME_DeleteSelection(ME_TextEditor *editor);
172 void ME_SendSelChange(ME_TextEditor *editor);
173 void ME_InsertGraphicsFromCursor(ME_TextEditor *editor, int nCursor);
174 void ME_InsertTableCellFromCursor(ME_TextEditor *editor, int nCursor);
175 void ME_InternalDeleteText(ME_TextEditor *editor, int nOfs, int nChars);
176 int ME_GetTextLength(ME_TextEditor *editor);
177 int ME_GetTextLengthEx(ME_TextEditor *editor, GETTEXTLENGTHEX *how);
178 ME_Style *ME_GetSelectionInsertStyle(ME_TextEditor *editor);
179 BOOL ME_UpdateSelection(ME_TextEditor *editor, ME_Cursor *pTempCursor);
180
181 /* wrap.c */
182 void ME_PrepareParagraphForWrapping(ME_Context *c, ME_DisplayItem *tp);
183 ME_DisplayItem *ME_MakeRow(int height, int baseline, int width);
184 void ME_InsertRowStart(ME_WrapContext *wc, ME_DisplayItem *pEnd);
185 void ME_WrapTextParagraph(ME_Context *c, ME_DisplayItem *tp);
186 BOOL ME_WrapMarkedParagraphs(ME_TextEditor *editor);
187 void ME_SendRequestResize(ME_TextEditor *editor, BOOL force);
188
189 /* para.c */
190 ME_DisplayItem *ME_GetParagraph(ME_DisplayItem *run); 
191 void ME_MakeFirstParagraph(HDC hDC, ME_TextBuffer *editor);
192 ME_DisplayItem *ME_SplitParagraph(ME_TextEditor *editor, ME_DisplayItem *rp, ME_Style *style);
193 ME_DisplayItem *ME_JoinParagraphs(ME_TextEditor *editor, ME_DisplayItem *tp);
194 void ME_DumpParaStyle(ME_Paragraph *s);
195 void ME_DumpParaStyleToBuf(PARAFORMAT2 *pFmt, char buf[2048]);
196 void ME_SetParaFormat(ME_TextEditor *editor, ME_DisplayItem *para, PARAFORMAT2 *pFmt);
197 void ME_SetSelectionParaFormat(ME_TextEditor *editor, PARAFORMAT2 *pFmt);
198 void ME_GetParaFormat(ME_TextEditor *editor, ME_DisplayItem *para, PARAFORMAT2 *pFmt);
199 void ME_GetSelectionParaFormat(ME_TextEditor *editor, PARAFORMAT2 *pFmt);
200 /* marks from first up to (but not including) last */
201 void ME_MarkForWrapping(ME_TextEditor *editor, ME_DisplayItem *first, ME_DisplayItem *last);
202 void ME_MarkAllForWrapping(ME_TextEditor *editor);
203
204 /* paint.c */
205 void ME_PaintContent(ME_TextEditor *editor, HDC hDC, BOOL bOnlyNew, RECT *rcUpdate);
206 void ME_Repaint(ME_TextEditor *editor);
207 void ME_RewrapRepaint(ME_TextEditor *editor);
208 void ME_UpdateRepaint(ME_TextEditor *editor);
209 void ME_DrawParagraph(ME_Context *c, ME_DisplayItem *paragraph);
210 void ME_UpdateScrollBar(ME_TextEditor *editor);
211 int ME_GetYScrollPos(ME_TextEditor *editor);
212 void ME_EnsureVisible(ME_TextEditor *editor, ME_DisplayItem *pRun);
213 COLORREF ME_GetBackColor(ME_TextEditor *editor);
214 void ME_Scroll(ME_TextEditor *editor, int cx, int cy);
215 void ME_InvalidateFromOfs(ME_TextEditor *editor, int nCharOfs);
216 void ME_InvalidateSelection(ME_TextEditor *editor);
217 void ME_QueueInvalidateFromCursor(ME_TextEditor *editor, int nCursor);
218 BOOL ME_SetZoom(ME_TextEditor *editor, int numerator, int denominator);
219
220 /* richole.c */
221 extern LRESULT CreateIRichEditOle(LPVOID *);
222
223 /* wintest.c */
224
225 /* editor.c */
226 void ME_RegisterEditorClass(HINSTANCE hInstance);
227 ME_TextEditor *ME_MakeEditor(HWND hWnd);
228 void ME_DestroyEditor(ME_TextEditor *editor);
229 void ME_SendOldNotify(ME_TextEditor *editor, int nCode);
230 ME_UndoItem *ME_AddUndoItem(ME_TextEditor *editor, ME_DIType type, ME_DisplayItem *di);
231 void ME_CommitUndo(ME_TextEditor *editor);
232 void ME_Undo(ME_TextEditor *editor);
233 void ME_Redo(ME_TextEditor *editor);
234 void ME_EmptyUndoStack(ME_TextEditor *editor);
235 int ME_GetTextW(ME_TextEditor *editor, WCHAR *buffer, int nStart, int nChars, BOOL bCRLF);
236 ME_DisplayItem *ME_FindItemAtOffset(ME_TextEditor *editor, ME_DIType nItemType, int nOffset, int *nItemOffset);
237 void ME_StreamInFill(ME_InStream *stream);
238
239 extern int me_debug;
240 extern HANDLE me_heap;
241 extern void DoWrap(ME_TextEditor *editor);
242
243 /* writer.c */
244 LRESULT ME_StreamOutRange(ME_TextEditor *editor, DWORD dwFormat, int nStart, int nTo, EDITSTREAM *stream);
245 LRESULT ME_StreamOut(ME_TextEditor *editor, DWORD dwFormat, EDITSTREAM *stream);