X-Git-Url: http://winboard.nl/cgi-bin?p=xboard.git;a=blobdiff_plain;f=dialogs.h;h=99b01e40e46dda6bcd7ed5789103ceffa77a88de;hp=cbc6cbfa5052048f258030d287a172ebb82d0007;hb=HEAD;hpb=36c1871d84e1132cee5c4c7fe4363c442fa34af2 diff --git a/dialogs.h b/dialogs.h index cbc6cbf..99b01e4 100644 --- a/dialogs.h +++ b/dialogs.h @@ -1,7 +1,7 @@ /* * dialogs.h -- shared variables for generic dialog popup of XBoard * - * Copyright 2000, 2009, 2010, 2011, 2012 Free Software Foundation, Inc. + * Copyright 2000, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Free Software Foundation, Inc. * ------------------------------------------------------------------------ * * GNU XBoard is free software: you can redistribute it and/or modify @@ -20,45 +20,201 @@ *------------------------------------------------------------------------ ** See the file ChangeLog for a revision history. */ -typedef enum { -TransientDlg=0, CommentDlg, TagsDlg, TextMenuDlg, InputBoxDlg, ErrorDlg, BrowserDlg, HistoryDlg, NrOfDialogs +// [HGM] Some remarks about the generic dialog creator of XBoard: +// GenericPopUp is needed to create a dialog from the lists of options supplied by the engines. +// But once it is there, it provides a very easy way for creating other settings dialogs as well, +// by letting XBoard provide its own, compiled-in lists of XBoard options (located in dialogs.c). +// The Option struct uses the following fields (E = for engine options, X = for XBoard options): +// Option types | XBoard-only -> +// TYPE NAME spin check string combo button box label list graph menu break end +// int value E E (h) X/E [w] (h) (h) +// int min X/E (2) (3) (1) (1) (1) (1) (3) (1) (4) +// int max X/E (w) (w) (w) (w) (w) (w) (w) (w) +// void* handle X/E X/E X/E X/E X/E X X X X X +// void* target X X X X/C C X X C C +// char* textValue X/E X/E * +// char ** choice C X/E * X +// enum type X/E X/E X/E X/E X X X X X X X X +// char * name X/E X/E X/E X/E X X X X X +// char ** font X X X X (GTK only) +// File and Path options are like String (but get a browse button added in the dialog), and Slider +// is like Spin. Menu can be PopUp or PopDown; both need the COMBO_CALLBACK bit (3) set! +// (h) or (w) means the field optionally (when non-null) specifies the height or width of the main +// control element (excluding accompanying description texts). [w] means the width is written there. +// C specifies the 'target' is a user-supplied callback function, which will be executed when the +// option is exercised. + + +/* Flags Option.min used (2) for TextBox (-string): */ +#define T_VSCRL (1 << 0) +#define T_HSCRL (1 << 1) +#define T_FILL (1 << 2) +#define T_WRAP (1 << 3) +#define T_TOP (1 << 4) + +/* Flags Option.min used (3) for ComboBox (-combo) and menus (PopUp, PopDown): */ +#define COMBO_CALLBACK (1 << 0) +#define NO_GETTEXT (1 << 2) + +/* Flags for Option.min used (1) for Button, SaveButton, ListBox, Label: */ +#define SAME_ROW (1 << 0) /* also in Break & EndMark */ +#define BORDER (1 << 1) /* Label */ +#define FIX_H (1 << 1) /* in other, this bit specifies top and botom of the control chain to same window edge */ +#define B2B (1 << 2) /* chain bottom to bottom (by default, no chaining is done) */ +#define T2T (1 << 3) +#define R2R (1 << 4) +#define L2R (1 << 5) +#define R2L (1 << 6) +#define L2L (1 << 7) +#define TT (T2T|FIX_H) /* useful combinations: 0xA = entirely to top */ +#define BB (B2B|FIX_H) /* 6 = entirely to bottom */ +#define TB (B2B|T2T) /* 0xC = absorb all vertical size change */ +#define LL (L2L|R2L) /* 0xC0 = entirely to left */ +#define RR (L2R|R2R) /* 0x30 = entirely to right */ +#define LR (L2L|R2R) /* 0x90 = absorb all horizontal size change */ + +/* Flags for Option.min used (4) for EndMark: */ +#define NO_OK (1 << 1) +#define NO_CANCEL (1 << 2) + +#define REPLACE (1 << 16) + +#define MODAL 1 +#define NONMODAL 0 + +/* Board widget numbers, MUST correspond to mainOptions array */ + +#define W_MENU 0 // main menu bar +#define W_ENGIN 6 // engine menu +#define W_TITLE 10 +#define W_WHITE 12 +#define W_BLACK 13 +#define W_SMALL 15 // title in small layout +#define W_MESSG 16 +#define W_BUTTON 17 // button bar +#define W_PAUSE 20 +#define W_BOARD 24 +#define W_MENUW 25 +#define W_MENUB 26 +#define W_DROP 27 // drop (popup) menu + +typedef enum { // identifier of dialogs done by GenericPopup +TransientDlg=0, // transient: grabs mouse events and is destroyed at pop-down (so other dialog can use this ID next time) +CommentDlg, TagsDlg, TextMenuDlg, InputBoxDlg, ChatDlg, DummyDlg, HistoryDlg, // persistent: no grab and reused +GameListDlg, +EngOutDlg, +EvalGraphDlg, +PromoDlg, // this and beyond are destroyed at pop-down +ErrorDlg, +AskDlg, // this and beyond do grab mouse events (and are destroyed) +FatalDlg, +BoardWindow, +BrowserDlg, +MasterDlg, +NrOfDialogs // dummy for total } DialogClass; +typedef int MemoCallback (Option *opt, int n, int x, int y, char *text, int index); +typedef Option *PointerCallback(int n, int x, int y); +typedef void ListBoxCallback(int n, int selected); typedef void ButtonCallback(int n); typedef int OKCallback(int n); extern char commentTranslations[]; extern char historyTranslations[]; -extern Pixel timerBackgroundPixel; +//extern Pixel timerBackgroundPixel; extern int values[]; extern ChessProgramState *currentCps; extern int dialogError; extern ButtonCallback *comboCallback; +extern void *userLogo; -extern WindowPlacement wpComment, wpTags, wpMoveHistory; +extern WindowPlacement wpComment, wpTags, wpMoveHistory, wpMain, wpDualBoard, wpConsole; extern char *marked[]; extern Boolean shellUp[]; -extern Option textOptions[], boxOptions[]; +extern Option textOptions[], typeOptions[], dualOptions[], mainOptions[]; +extern Option historyOptions[], engoutOptions[], gamesOptions[], chatOptions[], tagsOptions[], commentOptions[]; +#define MAX_SIZE 130 +extern Boolean fontIsSet[], fontValid[][MAX_SIZE]; +extern int initialSquareSize; +extern char *fontTable[][MAX_SIZE]; +void GetPlacement P((DialogClass dlg, WindowPlacement *wp)); int DialogExists P((DialogClass n)); -int GenericPopUp P((Option *option, char *title, DialogClass dlgNr)); +int GenericPopUp P((Option *option, char *title, DialogClass dlgNr, DialogClass parent, int modal, int topLevel)); int GenericReadout P((Option *currentOption, int selected)); int PopDown P((DialogClass n)); +void MarkMenu P((char *item, int dlgNr)); int AppendText P((Option *opt, char *s)); +void AppendColorized P((Option *opt, char *s, int count)); +void Show P((Option *opt, int hide)); +int IcsHist P((int dir, Option *opt, DialogClass dlg)); +void HighlightText P((Option *opt, int from, int to, Boolean highlight)); void SetColor P((char *colorName, Option *box)); -void ColorChanged P((Widget w, XtPointer data, XEvent *event, Boolean *b)); +//void ColorChanged P((Widget w, XtPointer data, XEvent *event, Boolean *b)); void SetInsertPos P((Option *opt, int pos)); -void HardSetFocus P((Option *opt)); +void HardSetFocus P((Option *opt, DialogClass dlg)); +void CursorAtEnd P((Option *opt)); void GetWidgetText P((Option *opt, char **buf)); void SetWidgetText P((Option *opt, char *buf, int n)); void GetWidgetState P((Option *opt, int *state)); void SetWidgetState P((Option *opt, int state)); +void SetWidgetLabel P((Option *opt, char *buf)); +void SetComboChoice P((Option *opt, int choice)); void SetDialogTitle P((DialogClass dlg, char *title)); -void AddHandler P((Option *opt, int nr)); +void LoadListBox P((Option *opt, char *emptyText, int n1, int n2)); +void HighlightListBoxItem P((Option *opt, int nr)); +void HighlightWithScroll P((Option *opt, int sel, int max)); +void ScrollToCursor P((Option *opt, int pos)); +int SelectedListBoxItem P((Option *opt)); +void BoardFocus P((void)); +void FocusOnWidget P((Option *opt, DialogClass dlg)); +void UnCaret P((void)); +void SetIconName P((DialogClass dlg, char *name)); +int ReadScroll P((Option *opt, float *top, float *bottom)); +void SetScroll P((Option *opt, float f)); +void AddHandler P((Option *opt, DialogClass dlg, int nr)); void SendText P((int n)); +void DisplayLogos P((Option *left, Option *right)); +void StartDir P((char *filter, char *newName)); +void Browse P((DialogClass dlg, char *label, char *proposed, char *ext, + Boolean pathFlag, char *mode, char **name, FILE **fp)); +void FileNamePopUpWrapper P((char *label, char *def, char *filter, FileProc proc, + Boolean pathFlag, char *openMode, char **openName, FILE **openFP)); -void InitDrawingParams P(()); // in xboard.c +void InitDrawingParams P((int reload)); // in draw.c +void InitDrawingHandle P((Option *opt)); +void ExposeRedraw P((Option *opt, int x, int y, int w, int h)); +void DrawLogo P((Option *opt, void *logo)); +void ErrorPopUp P((char *title, char *text, int modal)); +int ShiftKeys P((void)); +void SetClockIcon P((int color)); +void DelayedLoad P((void)); +void DisplayTimerLabel P((Option *opt, char *color, long timer, int highlight)); +void SetWindowTitle P((char *text, char *title, char *icon)); +void SetupDropMenu P((void)); +Option *BoardPopUp P((int squareSize, int lineGap, void *clockFontThingy)); +void SlaveResize P((Option *opt)); +int SetCurrentComboSelection P((Option *opt)); void BoxAutoPopUp P((char *buf)); +void ConsoleAutoPopUp P((char *buf)); +void IcsKey P((int n)); +void ICSInputBoxPopUp P((void)); +void LoadOptionsPopUp P((DialogClass parent)); +void GameListOptionsPopUp P((DialogClass parent)); +void RefreshColor P((int source, int n)); +void SendString P((char *p)); +void DisplayHelp P((char *name)); +void WidgetEcho P((Option *opt, int n)); +int ErrorOK P((int n)); +void ApplyFont P((Option *opt, char *font)); +void LockBoardSize P((int after)); +void Preview P((int n, char *s)); +void DrawPosition P((int fullRedraw, Board b)); + +// in ngamelist.c +int GameListClicks P((int direction)); +void SetFilter P((void));