xref: /vim-8.2.3635/src/gui.h (revision fcfe1a9b)
1 /* vi:set ts=8 sts=4 sw=4 noet:
2  *
3  * VIM - Vi IMproved		by Bram Moolenaar
4  *				Motif support by Robert Webb
5  *
6  * Do ":help uganda"  in Vim to read copying and usage conditions.
7  * Do ":help credits" in Vim to see a list of people who contributed.
8  */
9 
10 #ifdef FEAT_GUI_MOTIF
11 # include <Xm/Xm.h>
12 #endif
13 
14 #ifdef FEAT_GUI_ATHENA
15 # include <X11/Intrinsic.h>
16 # include <X11/StringDefs.h>
17 #endif
18 
19 #ifdef FEAT_GUI_GTK
20 # ifdef VMS /* undef MIN and MAX because Intrinsic.h redefines them anyway */
21 #  ifdef MAX
22 #   undef MAX
23 #  endif
24 #  ifdef MIN
25 #   undef MIN
26 #  endif
27 # endif
28 # include <X11/Intrinsic.h>
29 # include <gtk/gtk.h>
30 #endif
31 
32 // Needed when generating prototypes, since FEAT_GUI is always defined then.
33 #if defined(FEAT_XCLIPBOARD) && !defined(FEAT_GUI_MOTIF) \
34 	&& !defined(FEAT_GUI_ATHENA) && !defined(FEAT_GUI_GTK)
35 # include <X11/Intrinsic.h>
36 #endif
37 
38 #ifdef FEAT_GUI_MAC
39 # include <Types.h>
40 /*# include <Memory.h>*/
41 # include <Quickdraw.h>
42 # include <Fonts.h>
43 # include <Events.h>
44 # include <Menus.h>
45 # if !(defined (TARGET_API_MAC_CARBON) && (TARGET_API_MAC_CARBON))
46 #  include <Windows.h>
47 # endif
48 # include <Controls.h>
49 /*# include <TextEdit.h>*/
50 # include <Dialogs.h>
51 # include <OSUtils.h>
52 /*
53 # include <ToolUtils.h>
54 # include <SegLoad.h>*/
55 #endif
56 
57 #ifdef FEAT_GUI_PHOTON
58 # include <Ph.h>
59 # include <Pt.h>
60 # include "photon/PxProto.h"
61 #endif
62 
63 /*
64  * On some systems scrolling needs to be done right away instead of in the
65  * main loop.
66  */
67 #if defined(FEAT_GUI_MSWIN) || defined(FEAT_GUI_MAC) || defined(FEAT_GUI_GTK)
68 # define USE_ON_FLY_SCROLL
69 #endif
70 
71 /*
72  * GUIs that support dropping files on a running Vim.
73  */
74 #if (defined(FEAT_DND) && defined(FEAT_GUI_GTK)) \
75 	|| defined(FEAT_GUI_MSWIN) \
76 	|| defined(FEAT_GUI_MAC)
77 # define HAVE_DROP_FILE
78 #endif
79 
80 /*
81  * This define makes menus always use a fontset.
82  * We're not sure if this code always works, thus it can be disabled.
83  */
84 #ifdef FEAT_XFONTSET
85 # define FONTSET_ALWAYS
86 #endif
87 
88 /*
89  * These macros convert between character row/column and pixel coordinates.
90  * TEXT_X   - Convert character column into X pixel coord for drawing strings.
91  * TEXT_Y   - Convert character row into Y pixel coord for drawing strings.
92  * FILL_X   - Convert character column into X pixel coord for filling the area
93  *		under the character.
94  * FILL_Y   - Convert character row into Y pixel coord for filling the area
95  *		under the character.
96  * X_2_COL  - Convert X pixel coord into character column.
97  * Y_2_ROW  - Convert Y pixel coord into character row.
98  */
99 #ifdef FEAT_GUI_MSWIN
100 # define TEXT_X(col)	((col) * gui.char_width)
101 # define TEXT_Y(row)	((row) * gui.char_height + gui.char_ascent)
102 # define FILL_X(col)	((col) * gui.char_width)
103 # define FILL_Y(row)	((row) * gui.char_height)
104 # define X_2_COL(x)	((x) / gui.char_width)
105 # define Y_2_ROW(y)	((y) / gui.char_height)
106 #else
107 # define TEXT_X(col)	((col) * gui.char_width  + gui.border_offset)
108 # define FILL_X(col)	((col) * gui.char_width  + gui.border_offset)
109 # define X_2_COL(x)	(((x) - gui.border_offset) / gui.char_width)
110 # define TEXT_Y(row)	((row) * gui.char_height + gui.char_ascent \
111 							+ gui.border_offset)
112 # define FILL_Y(row)	((row) * gui.char_height + gui.border_offset)
113 # define Y_2_ROW(y)	(((y) - gui.border_offset) / gui.char_height)
114 #endif
115 
116 /* Indices for arrays of scrollbars */
117 #define SBAR_NONE	    -1
118 #define SBAR_LEFT	    0
119 #define SBAR_RIGHT	    1
120 #define SBAR_BOTTOM	    2
121 
122 /* Orientations for scrollbars */
123 #define SBAR_VERT	    0
124 #define SBAR_HORIZ	    1
125 
126 /* Default size of scrollbar */
127 #define SB_DEFAULT_WIDTH    16
128 
129 /* Default height of the menu bar */
130 #define MENU_DEFAULT_HEIGHT 1		/* figure it out at runtime */
131 
132 /* Flags for gui_mch_outstr_nowrap() */
133 #define GUI_MON_WRAP_CURSOR	0x01	/* wrap cursor at end of line */
134 #define GUI_MON_INVERT		0x02	/* invert the characters */
135 #define GUI_MON_IS_CURSOR	0x04	/* drawing cursor */
136 #define GUI_MON_TRS_CURSOR	0x08	/* drawing transparent cursor */
137 #define GUI_MON_NOCLEAR		0x10	/* don't clear selection */
138 
139 /* Flags for gui_mch_draw_string() */
140 #define DRAW_TRANSP		0x01	/* draw with transparent bg */
141 #define DRAW_BOLD		0x02	/* draw bold text */
142 #define DRAW_UNDERL		0x04	/* draw underline text */
143 #define DRAW_UNDERC		0x08	/* draw undercurl text */
144 #if defined(FEAT_GUI_GTK)
145 # define DRAW_ITALIC		0x10	/* draw italic text */
146 #endif
147 #define DRAW_CURSOR		0x20	/* drawing block cursor (win32) */
148 #define DRAW_STRIKE		0x40	/* strikethrough */
149 
150 /* For our own tearoff menu item */
151 #define TEAR_STRING		"-->Detach"
152 #define TEAR_LEN		(9)	/* length of above string */
153 
154 /* for the toolbar */
155 #define TOOLBAR_BUTTON_HEIGHT	18
156 #define TOOLBAR_BUTTON_WIDTH	18
157 #define TOOLBAR_BORDER_HEIGHT	12  /* room above+below buttons for MSWindows */
158 
159 #ifdef FEAT_GUI_MSWIN
160 # define TABLINE_HEIGHT 22
161 #endif
162 #ifdef FEAT_GUI_MOTIF
163 # define TABLINE_HEIGHT 30
164 #endif
165 
166 #if defined(NO_CONSOLE) || defined(FEAT_GUI_GTK) || defined(FEAT_GUI_X11)
167 # define NO_CONSOLE_INPUT	/* use no_console_input() to check if there
168 				   is no console input possible */
169 #endif
170 
171 typedef struct GuiScrollbar
172 {
173     long	ident;		/* Unique identifier for each scrollbar */
174     win_T	*wp;		/* Scrollbar's window, NULL for bottom */
175     int		type;		/* one of SBAR_{LEFT,RIGHT,BOTTOM} */
176     long	value;		/* Represents top line number visible */
177 #ifdef FEAT_GUI_ATHENA
178     int		pixval;		/* pixel count of value */
179 #endif
180     long	size;		/* Size of scrollbar thumb */
181     long	max;		/* Number of lines in buffer */
182 
183     /* Values measured in characters: */
184     int		top;		/* Top of scroll bar (chars from row 0) */
185     int		height;		/* Current height of scroll bar in rows */
186     int		width;		/* Current width of scroll bar in cols */
187     int		status_height;	/* Height of status line */
188 #ifdef FEAT_GUI_X11
189     Widget	id;		/* Id of real scroll bar */
190 #endif
191 #ifdef FEAT_GUI_GTK
192     GtkWidget *id;		/* Id of real scroll bar */
193     unsigned long handler_id;   /* Id of "value_changed" signal handler */
194 #endif
195 
196 #ifdef FEAT_GUI_MSWIN
197     HWND	id;		/* Id of real scroll bar */
198     int		scroll_shift;	/* The scrollbar stuff can handle only up to
199 				   32767 lines.  When the file is longer,
200 				   scroll_shift is set to the number of shifts
201 				   to reduce the count.  */
202 #endif
203 #ifdef FEAT_GUI_MAC
204     ControlHandle id;		/* A handle to the scrollbar */
205 #endif
206 #ifdef FEAT_GUI_PHOTON
207     PtWidget_t	*id;
208 #endif
209 } scrollbar_T;
210 
211 typedef long	    guicolor_T;	/* handle for a GUI color; for X11 this should
212 				   be "Pixel", but that's an unsigned and we
213 				   need a signed value */
214 #define INVALCOLOR (guicolor_T)-11111	/* number for invalid color; on 32 bit
215 				   displays there is a tiny chance this is an
216 				   actual color */
217 #define CTERMCOLOR (guicolor_T)-11110	/* only used for cterm.bg_rgb and
218 					   cterm.fg_rgb: use cterm color */
219 
220 #ifdef FEAT_GUI_GTK
221   typedef PangoFontDescription	*GuiFont;       /* handle for a GUI font */
222   typedef PangoFontDescription  *GuiFontset;    /* handle for a GUI fontset */
223 # define NOFONT		(GuiFont)NULL
224 # define NOFONTSET	(GuiFontset)NULL
225 #else
226 # ifdef FEAT_GUI_PHOTON
227   typedef char		*GuiFont;
228   typedef char		*GuiFontset;
229 #  define NOFONT	(GuiFont)NULL
230 #  define NOFONTSET	(GuiFontset)NULL
231 # else
232 #  ifdef FEAT_GUI_X11
233   typedef XFontStruct	*GuiFont;	/* handle for a GUI font */
234   typedef XFontSet	GuiFontset;	/* handle for a GUI fontset */
235 #   define NOFONT	(GuiFont)0
236 #   define NOFONTSET	(GuiFontset)0
237 #  else
238   typedef long_u	GuiFont;	/* handle for a GUI font */
239   typedef long_u	GuiFontset;	/* handle for a GUI fontset */
240 #   define NOFONT	(GuiFont)0
241 #   define NOFONTSET	(GuiFontset)0
242 #  endif
243 # endif
244 #endif
245 
246 #ifdef VIMDLL
247 // Use spawn when GUI is starting.
248 # define GUI_MAY_SPAWN
249 
250 // Uncomment the next definition if you want to use the `:gui` command on
251 // Windows.  It uses `:mksession` to inherit the session from vim.exe to
252 // gvim.exe.  So, it doesn't work perfectly. (EXPERIMENTAL)
253 //# define EXPERIMENTAL_GUI_CMD
254 #endif
255 
256 typedef struct Gui
257 {
258     int		in_focus;	    /* Vim has input focus */
259     int		in_use;		    /* Is the GUI being used? */
260     int		starting;	    /* GUI will start in a little while */
261     int		shell_created;	    /* Has the shell been created yet? */
262     int		dying;		    /* Is vim dying? Then output to terminal */
263     int		dofork;		    /* Use fork() when GUI is starting */
264 #ifdef GUI_MAY_SPAWN
265     int		dospawn;	    /* Use spawn() when GUI is starting */
266 #endif
267     int		dragged_sb;	    /* Which scrollbar being dragged, if any? */
268     win_T	*dragged_wp;	    /* Which WIN's sb being dragged, if any? */
269     int		pointer_hidden;	    /* Is the mouse pointer hidden? */
270     int		col;		    /* Current cursor column in GUI display */
271     int		row;		    /* Current cursor row in GUI display */
272     int		cursor_col;	    /* Physical cursor column in GUI display */
273     int		cursor_row;	    /* Physical cursor row in GUI display */
274     char	cursor_is_valid;    /* There is a cursor at cursor_row/col */
275     int		num_cols;	    /* Number of columns */
276     int		num_rows;	    /* Number of rows */
277     int		scroll_region_top;  /* Top (first) line of scroll region */
278     int		scroll_region_bot;  /* Bottom (last) line of scroll region */
279     int		scroll_region_left;  /* Left (first) column of scroll region */
280     int		scroll_region_right;  /* Right (last) col. of scroll region */
281     int		highlight_mask;	    /* Highlight attribute mask */
282     int		scrollbar_width;    /* Width of vertical scrollbars */
283     int		scrollbar_height;   /* Height of horizontal scrollbar */
284     int		left_sbar_x;	    /* Calculated x coord for left scrollbar */
285     int		right_sbar_x;	    /* Calculated x coord for right scrollbar */
286 
287 #ifdef FEAT_MENU
288 # ifndef FEAT_GUI_GTK
289     int		menu_height;	    /* Height of the menu bar */
290     int		menu_width;	    /* Width of the menu bar */
291 # endif
292     char	menu_is_active;	    /* TRUE if menu is present */
293 # ifdef FEAT_GUI_ATHENA
294     char	menu_height_fixed;  /* TRUE if menu height fixed */
295 # endif
296 #endif
297 
298     scrollbar_T bottom_sbar;	    /* Bottom scrollbar */
299     int		which_scrollbars[3];/* Which scrollbar boxes are active? */
300     int		prev_wrap;	    /* For updating the horizontal scrollbar */
301     int		char_width;	    /* Width of char cell in pixels */
302     int		char_height;	    /* Height of char cell in pixels, includes
303 				       'linespace' */
304     int		char_ascent;	    /* Ascent of char in pixels */
305     int		border_width;	    /* Width of our border around text area */
306     int		border_offset;	    /* Total pixel offset for all borders */
307 
308     GuiFont	norm_font;	    /* Normal font */
309 #ifndef FEAT_GUI_GTK
310     GuiFont	bold_font;	    /* Bold font */
311     GuiFont	ital_font;	    /* Italic font */
312     GuiFont	boldital_font;	    /* Bold-Italic font */
313 #else
314     int		font_can_bold;	    /* Whether norm_font supports bold weight.
315 				     * The styled font variants are not used. */
316 #endif
317 
318 #if defined(FEAT_MENU) && !defined(FEAT_GUI_GTK)
319 # ifdef FONTSET_ALWAYS
320     GuiFontset	menu_fontset;	    /* set of fonts for multi-byte chars */
321 # else
322     GuiFont	menu_font;	    /* menu item font */
323 # endif
324 #endif
325     GuiFont	wide_font;	    /* Normal 'guifontwide' font */
326 #ifndef FEAT_GUI_GTK
327     GuiFont	wide_bold_font;	    /* Bold 'guifontwide' font */
328     GuiFont	wide_ital_font;	    /* Italic 'guifontwide' font */
329     GuiFont	wide_boldital_font; /* Bold-Italic 'guifontwide' font */
330 #endif
331 #ifdef FEAT_XFONTSET
332     GuiFontset	fontset;	    /* set of fonts for multi-byte chars */
333 #endif
334     guicolor_T	back_pixel;	    /* Color of background */
335     guicolor_T	norm_pixel;	    /* Color of normal text */
336     guicolor_T	def_back_pixel;	    /* default Color of background */
337     guicolor_T	def_norm_pixel;	    /* default Color of normal text */
338 
339 #ifdef FEAT_GUI_X11
340     char	*rsrc_menu_fg_name;	/* Color of menu & dialog foreground */
341     guicolor_T	menu_fg_pixel;		/* Same in Pixel format */
342     char	*rsrc_menu_bg_name;	/* Color of menu & dialog background */
343     guicolor_T	menu_bg_pixel;		/* Same in Pixel format */
344     char	*rsrc_scroll_fg_name;	/* Color of scrollbar foreground */
345     guicolor_T	scroll_fg_pixel;	/* Same in Pixel format */
346     char	*rsrc_scroll_bg_name;	/* Color of scrollbar background */
347     guicolor_T	scroll_bg_pixel;	/* Same in Pixel format */
348 
349 # ifdef FEAT_GUI_MOTIF
350     guicolor_T	menu_def_fg_pixel;  /* Default menu foreground */
351     guicolor_T	menu_def_bg_pixel;  /* Default menu background */
352     guicolor_T	scroll_def_fg_pixel;  /* Default scrollbar foreground */
353     guicolor_T	scroll_def_bg_pixel;  /* Default scrollbar background */
354 # endif
355     Display	*dpy;		    /* X display */
356     Window	wid;		    /* Window id of text area */
357     int		visibility;	    /* Is shell partially/fully obscured? */
358     GC		text_gc;
359     GC		back_gc;
360     GC		invert_gc;
361     Cursor	blank_pointer;	    /* Blank pointer */
362 
363     /* X Resources */
364     char_u	*rsrc_font_name;    /* Resource font name, used if 'guifont'
365 				       not set */
366     char_u	*rsrc_bold_font_name; /* Resource bold font name */
367     char_u	*rsrc_ital_font_name; /* Resource italic font name */
368     char_u	*rsrc_boldital_font_name;  /* Resource bold-italic font name */
369     char_u	*rsrc_menu_font_name;    /* Resource menu Font name */
370     Bool	rsrc_rev_video;	    /* Use reverse video? */
371 
372     char_u	*geom;		    /* Geometry, eg "80x24" */
373     Bool	color_approx;	    /* Some color was approximated */
374 #endif
375 
376 #ifdef FEAT_GUI_GTK
377 # ifndef USE_GTK3
378     int		visibility;	    /* Is shell partially/fully obscured? */
379 # endif
380     GdkCursor	*blank_pointer;	    /* Blank pointer */
381 
382     /* X Resources */
383     char_u	*geom;		    /* Geometry, eg "80x24" */
384 
385     GtkWidget	*mainwin;	    /* top level GTK window */
386     GtkWidget	*formwin;	    /* manages all the windows below */
387     GtkWidget	*drawarea;	    /* the "text" area */
388 # ifdef FEAT_MENU
389     GtkWidget	*menubar;	    /* menubar */
390 # endif
391 # ifdef FEAT_TOOLBAR
392     GtkWidget	*toolbar;	    /* toolbar */
393 # endif
394 # ifdef FEAT_GUI_GNOME
395     GtkWidget	*menubar_h;	    /* menubar handle */
396     GtkWidget	*toolbar_h;	    /* toolbar handle */
397 # endif
398 # ifdef USE_GTK3
399     GdkRGBA	*fgcolor;	    /* GDK-styled foreground color */
400     GdkRGBA	*bgcolor;	    /* GDK-styled background color */
401     GdkRGBA	*spcolor;	    /* GDK-styled special color */
402 # else
403     GdkColor	*fgcolor;	    /* GDK-styled foreground color */
404     GdkColor	*bgcolor;	    /* GDK-styled background color */
405     GdkColor	*spcolor;	    /* GDK-styled special color */
406 # endif
407 # ifdef USE_GTK3
408     cairo_surface_t *surface;       /* drawarea surface */
409     gboolean	     by_signal;     /* cause of draw operation */
410 # else
411     GdkGC	*text_gc;	    /* cached GC for normal text */
412 # endif
413     PangoContext     *text_context; /* the context used for all text */
414     PangoFont	     *ascii_font;   /* cached font for ASCII strings */
415     PangoGlyphString *ascii_glyphs; /* cached code point -> glyph map */
416 # ifdef FEAT_GUI_TABLINE
417     GtkWidget	*tabline;	    /* tab pages line handle */
418 # endif
419 
420     GtkAccelGroup *accel_group;
421     GtkWidget	*filedlg;	    /* file selection dialog */
422     char_u	*browse_fname;	    /* file name from filedlg */
423 
424     guint32	event_time;
425 #endif	/* FEAT_GUI_GTK */
426 
427 #if defined(FEAT_GUI_TABLINE) \
428 	&& (defined(FEAT_GUI_MSWIN) || defined(FEAT_GUI_MOTIF) \
429 		|| defined(FEAT_GUI_MAC))
430     int		tabline_height;
431 #endif
432 
433 #ifdef FEAT_FOOTER
434     int		footer_height;	    /* height of the message footer */
435 #endif
436 
437 #if defined(FEAT_TOOLBAR) \
438 	&& (defined(FEAT_GUI_ATHENA) || defined(FEAT_GUI_MOTIF))
439     int		toolbar_height;	    /* height of the toolbar */
440 #endif
441 
442 #ifdef FEAT_BEVAL_TIP
443     /* Tooltip properties; also used for balloon evaluation */
444     char_u	*rsrc_tooltip_font_name; /* tooltip font name */
445     char	*rsrc_tooltip_fg_name;	/* tooltip foreground color name */
446     char	*rsrc_tooltip_bg_name;	/* tooltip background color name */
447     guicolor_T	tooltip_fg_pixel;	/* tooltip foreground color */
448     guicolor_T	tooltip_bg_pixel;	/* tooltip background color */
449     XFontSet	tooltip_fontset;	/* tooltip fontset */
450 #endif
451 
452 #ifdef FEAT_GUI_MSWIN
453     GuiFont	currFont;	    /* Current font */
454     guicolor_T	currFgColor;	    /* Current foreground text color */
455     guicolor_T	currBgColor;	    /* Current background text color */
456     guicolor_T	currSpColor;	    /* Current special text color */
457 #endif
458 
459 #ifdef FEAT_GUI_MAC
460     WindowPtr	VimWindow;
461     MenuHandle	MacOSHelpMenu;	    /* Help menu provided by the MacOS */
462     int		MacOSHelpItems;	    /* Nr of help-items supplied by MacOS */
463     WindowPtr	wid;		    /* Window id of text area */
464     int		visibility;	    /* Is window partially/fully obscured? */
465 #endif
466 
467 #ifdef FEAT_GUI_PHOTON
468     PtWidget_t	*vimWindow;		/* PtWindow */
469     PtWidget_t	*vimTextArea;		/* PtRaw */
470     PtWidget_t	*vimContainer;		/* PtPanel */
471 # if defined(FEAT_MENU) || defined(FEAT_TOOLBAR)
472     PtWidget_t	*vimToolBarGroup;
473 # endif
474 # ifdef FEAT_MENU
475     PtWidget_t	*vimMenuBar;
476 # endif
477 # ifdef FEAT_TOOLBAR
478     PtWidget_t	*vimToolBar;
479     int		toolbar_height;
480 # endif
481     PhEvent_t	*event_buffer;
482 #endif
483 
484 #ifdef FEAT_XIM
485     char	*rsrc_input_method;
486     char	*rsrc_preedit_type_name;
487 #endif
488 } gui_T;
489 
490 extern gui_T gui;			/* this is defined in gui.c */
491 
492 /* definitions of available window positionings for gui_*_position_in_parent()
493  */
494 typedef enum
495 {
496     VW_POS_MOUSE,
497     VW_POS_CENTER,
498     VW_POS_TOP_CENTER
499 } gui_win_pos_T;
500 
501 #ifdef FIND_REPLACE_DIALOG
502 /*
503  * Flags used to distinguish the different contexts in which the
504  * find/replace callback may be called.
505  */
506 # define FRD_FINDNEXT	1	/* Find next in find dialog */
507 # define FRD_R_FINDNEXT	2	/* Find next in repl dialog */
508 # define FRD_REPLACE	3	/* Replace once */
509 # define FRD_REPLACEALL	4	/* Replace remaining matches */
510 # define FRD_UNDO	5	/* Undo replaced text */
511 # define FRD_TYPE_MASK   7	/* Mask for the callback type */
512 /* Flags which change the way searching is done. */
513 # define FRD_WHOLE_WORD	0x08	/* match whole word only */
514 # define FRD_MATCH_CASE	0x10	/* match case */
515 #endif
516 
517 #ifdef FEAT_GUI_GTK
518 /*
519  * Convenience macros to convert from 'encoding' to 'termencoding' and
520  * vice versa.	If no conversion is necessary the passed-in pointer is
521  * returned as is, without allocating any memory.  Thus additional _FREE()
522  * macros are provided.  The _FREE() macros also set the pointer to NULL,
523  * in order to avoid bugs due to illegal memory access only happening if
524  * 'encoding' != utf-8...
525  *
526  * Defining these macros as pure expressions looks a bit tricky but
527  * avoids depending on the context of the macro expansion.  One of the
528  * rare occasions where the comma operator comes in handy :)
529  *
530  * Note: Do NOT keep the result around when handling control back to
531  * the main Vim!  The user could change 'encoding' at any time.
532  */
533 # define CONVERT_TO_UTF8(String)				\
534     ((output_conv.vc_type == CONV_NONE || (String) == NULL)	\
535 	    ? (String)						\
536 	    : string_convert(&output_conv, (String), NULL))
537 
538 # define CONVERT_TO_UTF8_FREE(String)				\
539     ((String) = ((output_conv.vc_type == CONV_NONE)		\
540 			? (char_u *)NULL			\
541 			: (vim_free(String), (char_u *)NULL)))
542 
543 # define CONVERT_FROM_UTF8(String)				\
544     ((input_conv.vc_type == CONV_NONE || (String) == NULL)	\
545 	    ? (String)						\
546 	    : string_convert(&input_conv, (String), NULL))
547 
548 # define CONVERT_FROM_UTF8_FREE(String)				\
549     ((String) = ((input_conv.vc_type == CONV_NONE)		\
550 			? (char_u *)NULL			\
551 			: (vim_free(String), (char_u *)NULL)))
552 
553 #else
554 # define CONVERT_TO_UTF8(String) (String)
555 # define CONVERT_TO_UTF8_FREE(String) ((String) = (char_u *)NULL)
556 # define CONVERT_FROM_UTF8(String) (String)
557 # define CONVERT_FROM_UTF8_FREE(String) ((String) = (char_u *)NULL)
558 #endif /* FEAT_GUI_GTK */
559 
560 #ifdef FEAT_GUI_GTK
561 /*
562  * The second parameter of g_signal_handlers_disconnect_by_func() is supposed
563  * to be a function pointer which was passed to g_signal_connect_*() somewhere
564  * previously, and hence it must be of type GCallback, i.e., void (*)(void).
565  *
566  * Meanwhile, g_signal_handlers_disconnect_by_func() is a macro calling
567  * g_signal_handlers_disconnect_matched(), and the second parameter of the
568  * former is to be passed to the sixth parameter of the latter the type of
569  * which, however, is declared as void * in the function signature.
570  *
571  * While the ISO C Standard does not require that function pointers be
572  * interconvertible to void *, widely-used compilers such as gcc and clang
573  * do such conversion implicitly and automatically on some platforms without
574  * issuing any warning.
575  *
576  * For Solaris Studio, that is not the case.  An explicit type cast is needed
577  * to suppress warnings on that particular conversion.
578  */
579 # if defined(__SUNPRO_C) && defined(USE_GTK3)
580 #  define FUNC2GENERIC(func) (void *)(func)
581 # else
582 #  define FUNC2GENERIC(func) G_CALLBACK(func)
583 # endif
584 #endif /* FEAT_GUI_GTK */
585 
586 #if defined(UNIX) && !defined(FEAT_GUI_MAC)
587 # define GUI_MAY_FORK
588 #endif
589