WINGs/WINGs/WINGsP.h

   1 #ifndef _WINGSP_H_
   2 #define _WINGSP_H_
   3
   4
   5 #include <X11/Xlib.h>
   6 #include <X11/Xutil.h>
   7
   8
   9 #include <WINGs/WINGs.h>
  10
  11 #if WINGS_H_VERSION < 20040406
  12 #error There_is_an_old_WINGs.h_file_somewhere_in_your_system._Please_remove_it.
  13 #endif
  14
  15 #include <assert.h>
  16
  17 #include <stdlib.h>
  18 #include <string.h>
  19 #include <stdio.h>
  20
  21 #ifdef __cplusplus
  22 extern "C" {
  23 #endif /* __cplusplus */
  24
  25
  26 #define DOUBLE_BUFFER   1
  27
  28 #define WC_UserWidget   128
  29
  30 #define SCROLLER_WIDTH  20
  31
  32 #define XDND_VERSION    4
  33
  34
  35 typedef struct W_Application {
  36     char *applicationName;
  37     int argc;
  38     char **argv;
  39     char *resourcePath;
  40 } W_Application;
  41
  42
  43 typedef struct W_Font {
  44     struct W_Screen *screen;
  45
  46     struct _XftFont *font;
  47
  48     short height;
  49     short y;
  50     short refCount;
  51     char *name;
  52 } W_Font;
  53
  54
  55 typedef struct W_Pixmap {
  56     struct W_Screen *screen;
  57     Pixmap pixmap;
  58     Pixmap mask;
  59     unsigned short width;
  60     unsigned short height;
  61     short depth;
  62     short refCount;
  63 } W_Pixmap;
  64
  65
  66 typedef struct W_Color {
  67     struct W_Screen *screen;
  68
  69     XColor color;
  70     unsigned short alpha;
  71     short refCount;
  72     GC gc;
  73     struct {
  74         unsigned int exact:1;
  75     } flags;
  76 } W_Color;
  77
  78
  79 typedef struct W_FocusInfo {
  80     struct W_View *toplevel;
  81     struct W_View *focused;            /* view that has the focus in this toplevel */
  82     struct W_FocusInfo *next;
  83 } W_FocusInfo;
  84
  85
  86
  87 typedef void* W_DndState(WMView *destView, XClientMessageEvent *event,
  88                          WMDraggingInfo *info);
  89
  90
  91 typedef struct W_DragOperationItem {
  92     WMDragOperationType type;
  93     char* text;
  94 } W_DragOperationItem;
  95
  96
  97 typedef struct W_DragSourceInfo {
  98     WMView *sourceView;
  99     Window destinationWindow;
 100     W_DndState *state;
 101     WMSelectionProcs *selectionProcs;
 102     Window icon;
 103     WMPoint imageLocation;
 104     WMPoint mouseOffset; /* mouse pos in icon */
 105     Cursor dragCursor;
 106     WMRect noPositionMessageZone;
 107     Atom firstThreeTypes[3];
 108 } W_DragSourceInfo;
 109
 110
 111 typedef struct W_DragDestinationInfo {
 112     WMView *destView;
 113     Window sourceWindow;
 114     W_DndState *state;
 115     WMArray *sourceTypes;
 116     WMArray *requiredTypes;
 117     Bool typeListAvailable;
 118     WMArray *dropDatas;
 119 } W_DragDestinationInfo;
 120
 121
 122 struct W_DraggingInfo {
 123     unsigned char protocolVersion;
 124     Time timestamp;
 125
 126     Atom sourceAction;
 127     Atom destinationAction;
 128
 129     W_DragSourceInfo* sourceInfo;    /* infos needed by source */
 130     W_DragDestinationInfo* destInfo; /* infos needed by destination */
 131 } W_DraggingInfo;
 132
 133
 134 typedef struct W_Screen {
 135     Display *display;
 136     int screen;
 137     int depth;
 138
 139     Colormap colormap;
 140
 141     Visual *visual;
 142
 143     Time lastEventTime;
 144
 145     Window rootWin;
 146
 147     struct W_View *rootView;
 148
 149     RContext *rcontext;
 150
 151     struct W_IMContext *imctx;
 152
 153     struct _XftDraw *xftdraw;          /* shared XftDraw */
 154
 155     /* application related */
 156
 157     W_FocusInfo *focusInfo;
 158
 159     RImage *applicationIconImage;      /* image (can have alpha channel) */
 160     struct W_Pixmap *applicationIconPixmap; /* pixmap - no alpha channel */
 161     Window applicationIconWindow;
 162
 163     struct W_Window *windowList;       /* list of windows in the app */
 164
 165     Window groupLeader;                /* the leader of the application */
 166                                        /* also used for other things */
 167
 168     struct W_SelectionHandlers *selectionHandlerList;
 169
 170     struct {
 171         unsigned int hasAppIcon:1;
 172         unsigned int simpleApplication:1;
 173     } aflags;
 174
 175     WMOpenPanel *sharedOpenPanel;
 176     WMSavePanel *sharedSavePanel;
 177
 178     struct W_FontPanel *sharedFontPanel;
 179
 180     struct W_ColorPanel *sharedColorPanel;
 181
 182     Pixmap stipple;
 183
 184     struct W_View *dragSourceView;
 185     struct W_DraggingInfo dragInfo;
 186
 187     /* colors */
 188     W_Color *white;
 189     W_Color *black;
 190     W_Color *gray;
 191     W_Color *darkGray;
 192
 193     GC stippleGC;
 194
 195     GC copyGC;
 196     GC clipGC;
 197
 198     GC monoGC;                         /* GC for 1bpp visuals */
 199
 200     GC xorGC;
 201
 202     GC ixorGC;                         /* IncludeInferiors XOR */
 203
 204     GC drawStringGC;                   /* for WMDrawString() */
 205
 206     GC drawImStringGC;                 /* for WMDrawImageString() */
 207
 208     W_Font *normalFont;
 209
 210     W_Font *boldFont;
 211
 212     WMHashTable *fontCache;
 213
 214     Bool antialiasedText;
 215
 216     unsigned int ignoredModifierMask; /* modifiers to ignore when typing txt */
 217
 218     struct W_Balloon *balloon;
 219
 220
 221     struct W_Pixmap *checkButtonImageOn;
 222     struct W_Pixmap *checkButtonImageOff;
 223
 224     struct W_Pixmap *radioButtonImageOn;
 225     struct W_Pixmap *radioButtonImageOff;
 226
 227     struct W_Pixmap *buttonArrow;
 228     struct W_Pixmap *pushedButtonArrow;
 229
 230     struct W_Pixmap *scrollerDimple;
 231
 232     struct W_Pixmap *upArrow;
 233     struct W_Pixmap *downArrow;
 234     struct W_Pixmap *leftArrow;
 235     struct W_Pixmap *rightArrow;
 236
 237     struct W_Pixmap *hiUpArrow;
 238     struct W_Pixmap *hiDownArrow;
 239     struct W_Pixmap *hiLeftArrow;
 240     struct W_Pixmap *hiRightArrow;
 241
 242     struct W_Pixmap *pullDownIndicator;
 243     struct W_Pixmap *popUpIndicator;
 244
 245     struct W_Pixmap *checkMark;
 246
 247     struct W_Pixmap *homeIcon;
 248     struct W_Pixmap *altHomeIcon;
 249
 250     struct W_Pixmap *trashcanIcon;
 251     struct W_Pixmap *altTrashcanIcon;
 252
 253     struct W_Pixmap *createDirIcon;
 254     struct W_Pixmap *altCreateDirIcon;
 255
 256     struct W_Pixmap *disketteIcon;
 257     struct W_Pixmap *altDisketteIcon;
 258     struct W_Pixmap *unmountIcon;
 259     struct W_Pixmap *altUnmountIcon;
 260
 261     struct W_Pixmap *magnifyIcon;
 262     /*struct W_Pixmap *altMagnifyIcon;*/
 263     struct W_Pixmap *wheelIcon;
 264     struct W_Pixmap *grayIcon;
 265     struct W_Pixmap *rgbIcon;
 266     struct W_Pixmap *cmykIcon;
 267     struct W_Pixmap *hsbIcon;
 268     struct W_Pixmap *customPaletteIcon;
 269     struct W_Pixmap *colorListIcon;
 270
 271     struct W_Pixmap *defaultObjectIcon;
 272
 273     Cursor defaultCursor;
 274
 275     Cursor textCursor;
 276
 277     Cursor invisibleCursor;
 278
 279     Atom attribsAtom;                  /* GNUstepWindowAttributes */
 280
 281     Atom deleteWindowAtom;             /* WM_DELETE_WINDOW */
 282
 283     Atom protocolsAtom;                /* _XA_WM_PROTOCOLS */
 284
 285     Atom clipboardAtom;                /* CLIPBOARD */
 286
 287     Atom xdndAwareAtom;                /* XdndAware */
 288     Atom xdndSelectionAtom;
 289     Atom xdndEnterAtom;
 290     Atom xdndLeaveAtom;
 291     Atom xdndPositionAtom;
 292     Atom xdndDropAtom;
 293     Atom xdndFinishedAtom;
 294     Atom xdndTypeListAtom;
 295     Atom xdndActionListAtom;
 296     Atom xdndActionDescriptionAtom;
 297     Atom xdndStatusAtom;
 298
 299     Atom xdndActionCopy;
 300     Atom xdndActionMove;
 301     Atom xdndActionLink;
 302     Atom xdndActionAsk;
 303     Atom xdndActionPrivate;
 304
 305     Atom wmIconDragOffsetAtom;
 306
 307     Atom wmStateAtom;                  /* WM_STATE */
 308
 309     Atom utf8String;
 310
 311     Atom netwmName;
 312     Atom netwmIconName;
 313     Atom netwmIcon;
 314
 315     /* stuff for detecting double-clicks */
 316     Time lastClickTime;                /* time of last mousedown event */
 317     Window lastClickWindow;            /* window of the last mousedown */
 318
 319     struct W_View *modalView;
 320     unsigned modalLoop:1;
 321     unsigned ignoreNextDoubleClick:1;
 322 } W_Screen;
 323
 324
 325
 326 typedef struct W_ViewDelegate {
 327     void *data;
 328
 329     void (*didMove)(struct W_ViewDelegate*, WMView*);
 330
 331     void (*didResize)(struct W_ViewDelegate*, WMView*);
 332
 333     void (*willMove)(struct W_ViewDelegate*, WMView*, int*, int*);
 334
 335     void (*willResize)(struct W_ViewDelegate*, WMView*,
 336                        unsigned int*, unsigned int*);
 337 } W_ViewDelegate;
 338
 339
 340
 341 typedef struct W_View {
 342     struct W_Screen *screen;
 343
 344     WMWidget *self;                    /* must point to the widget the
 345     * view belongs to */
 346
 347     W_ViewDelegate *delegate;
 348
 349     Window window;
 350
 351     WMSize size;
 352
 353     short topOffs;
 354     short leftOffs;
 355     short bottomOffs;
 356     short rightOffs;
 357
 358     WMPoint pos;
 359
 360     struct W_View *nextFocusChain;     /* next/prev in focus chain */
 361     struct W_View *prevFocusChain;
 362
 363     struct W_View *nextResponder;      /* next to receive keyboard events */
 364
 365     struct W_View *parent;             /* parent WMView */
 366
 367     struct W_View *childrenList;       /* first in list of child windows */
 368
 369     struct W_View *nextSister;         /* next on parent's children list */
 370
 371     WMArray *eventHandlers;            /* event handlers for this window */
 372
 373     unsigned long attribFlags;
 374     XSetWindowAttributes attribs;
 375
 376     void *hangedData;                  /* data holder for user program */
 377
 378     WMColor *backColor;
 379
 380     Cursor cursor;
 381
 382     Atom *droppableTypes;
 383     struct W_DragSourceProcs      *dragSourceProcs;
 384     struct W_DragDestinationProcs *dragDestinationProcs;
 385     WMPixmap *dragImage;
 386     int helpContext;
 387
 388
 389     struct {
 390         unsigned int realized:1;
 391         unsigned int mapped:1;
 392         unsigned int parentDying:1;
 393         unsigned int dying:1;           /* the view is being destroyed */
 394         unsigned int topLevel:1;        /* is a top level window */
 395         unsigned int root:1;            /* is the root window */
 396         unsigned int mapWhenRealized:1; /* map the view when it's realized */
 397         unsigned int alreadyDead:1;     /* view was freed */
 398
 399         unsigned int dontCompressMotion:1; /* motion notify event compress */
 400         unsigned int notifySizeChanged:1;
 401         unsigned int dontCompressExpose:1; /* expose event compress */
 402
 403         /* toplevel only */
 404         unsigned int worksWhenModal:1;
 405         unsigned int pendingRelease1:1;
 406         unsigned int pendingRelease2:1;
 407         unsigned int pendingRelease3:1;
 408         unsigned int pendingRelease4:1;
 409         unsigned int pendingRelease5:1;
 410         unsigned int xdndHintSet:1;
 411     } flags;
 412
 413     int refCount;
 414 } W_View;
 415
 416
 417 typedef struct W_EventHandler {
 418     unsigned long eventMask;
 419
 420     WMEventProc *proc;
 421
 422     void *clientData;
 423 } W_EventHandler;
 424
 425
 426
 427
 428 typedef struct _WINGsConfiguration {
 429     char *systemFont;
 430     char *boldSystemFont;
 431     int  defaultFontSize;
 432     Bool antialiasedText;
 433     char *floppyPath;
 434     unsigned doubleClickDelay;
 435     unsigned mouseWheelUp;
 436     unsigned mouseWheelDown;
 437 } _WINGsConfiguration;
 438
 439 extern _WINGsConfiguration WINGsConfiguration;
 440
 441
 442
 443 #define CHECK_CLASS(widget, class) assert(W_CLASS(widget)==(class))
 444
 445
 446 #define W_CLASS(widget)         (((W_WidgetType*)(widget))->widgetClass)
 447 #define W_VIEW(widget)          (((W_WidgetType*)(widget))->view)
 448
 449 #define W_VIEW_REALIZED(view)   (view)->flags.realized
 450 #define W_VIEW_MAPPED(view)     (view)->flags.mapped
 451
 452 #define W_VIEW_DISPLAY(view)    (view)->screen->display
 453 #define W_VIEW_SCREEN(view)     (view)->screen
 454 #define W_VIEW_DRAWABLE(view)   (view)->window
 455
 456 #define W_VIEW_WIDTH(view)      (view)->size.width
 457 #define W_VIEW_HEIGHT(view)     (view)->size.height
 458
 459
 460 #define W_PIXEL(c)              (c)->color.pixel
 461
 462 #define W_FONTID(f)             (f)->font->fid
 463
 464 #define W_DRAWABLE(scr)         (scr)->rcontext->drawable
 465
 466
 467
 468 W_View *W_GetViewForXWindow(Display *display, Window window);
 469
 470 W_View *W_CreateView(W_View *parent);
 471
 472 W_View *W_CreateTopView(W_Screen *screen);
 473
 474 W_View *W_CreateUnmanagedTopView(W_Screen *screen);
 475
 476
 477 W_View *W_CreateRootView(W_Screen *screen);
 478
 479 void W_DestroyView(W_View *view);
 480
 481 void W_RealizeView(W_View *view);
 482
 483 void W_ReparentView(W_View *view, W_View *newParent, int x, int y);
 484
 485 void W_RaiseView(W_View *view);
 486
 487 void W_LowerView(W_View *view);
 488
 489
 490 void W_MapView(W_View *view);
 491
 492 void W_MapSubviews(W_View *view);
 493
 494 void W_UnmapSubviews(W_View *view);
 495
 496 W_View *W_TopLevelOfView(W_View *view);
 497
 498 void W_UnmapView(W_View *view);
 499
 500 void W_MoveView(W_View *view, int x, int y);
 501
 502 void W_ResizeView(W_View *view, unsigned int width, unsigned int height);
 503
 504 void W_SetViewBackgroundColor(W_View *view, WMColor *color);
 505
 506 void W_SetViewCursor(W_View *view, Cursor cursor);
 507
 508 void W_DrawRelief(W_Screen *scr, Drawable d, int x, int y, unsigned int width,
 509                   unsigned int height, WMReliefType relief);
 510
 511 void W_DrawReliefWithGC(W_Screen *scr, Drawable d, int x, int y,
 512                         unsigned int width, unsigned int height,
 513                         WMReliefType relief,
 514                         GC black, GC dark, GC light, GC white);
 515
 516 void W_CallDestroyHandlers(W_View *view);
 517
 518 void W_PaintTextAndImage(W_View *view, int wrap, WMColor *textColor,
 519                          W_Font *font, WMReliefType relief, char *text,
 520                          WMAlignment alignment, W_Pixmap *image,
 521                          WMImagePosition position, WMColor *backColor, int ofs);
 522
 523 void W_PaintText(W_View *view, Drawable d, WMFont *font,  int x, int y,
 524                  int width, WMAlignment alignment, WMColor *color,
 525                  int wrap, char *text, int length);
 526
 527 int W_GetTextHeight(WMFont *font, char *text, int width, int wrap);
 528
 529
 530 int W_TextWidth(WMFont *font, char *text, int length);
 531
 532
 533 void W_BroadcastMessage(W_View *targetParent, XEvent *event);
 534
 535 void W_DispatchMessage(W_View *target, XEvent *event);
 536
 537 void W_SetFocusOfToplevel(W_View *toplevel, W_View *view);
 538
 539 W_View *W_FocusedViewOfToplevel(W_View *view);
 540
 541 void W_SetFocusOfTopLevel(W_View *toplevel, W_View *view);
 542
 543 void W_ReleaseView(WMView *view);
 544
 545 WMView *W_RetainView(WMView *view);
 546
 547 void W_InitApplication(WMScreen *scr);
 548
 549 void W_InitNotificationCenter(void);
 550
 551 W_Class W_RegisterUserWidget(void);
 552
 553 void W_RedisplayView(WMView *view);
 554
 555 Bool W_ApplicationInitialized(void);
 556
 557 void W_HandleSelectionEvent(XEvent *event);
 558
 559 void W_HandleDNDClientMessage(WMView *toplevel, XClientMessageEvent *event);
 560
 561 void W_FlushASAPNotificationQueue(void);
 562
 563 void W_FlushIdleNotificationQueue(void);
 564
 565 struct W_Balloon *W_CreateBalloon(WMScreen *scr);
 566
 567 void W_BalloonHandleEnterView(WMView *view);
 568
 569 void W_BalloonHandleLeaveView(WMView *view);
 570
 571 Bool W_CheckIdleHandlers(void);
 572
 573 void W_CheckTimerHandlers(void);
 574
 575 Bool W_HandleInputEvents(Bool waitForInput, int inputfd);
 576
 577 /* XDnD */
 578 Atom W_OperationToAction(WMScreen *scr, WMDragOperationType operation);
 579
 580 WMDragOperationType W_ActionToOperation(WMScreen *scr, Atom action);
 581
 582 void W_FreeDragOperationItem(void* item);
 583
 584 Bool W_SendDnDClientMessage(Display *dpy, Window win, Atom message,
 585                             unsigned long data1, unsigned long data2,
 586                             unsigned long data3, unsigned long data4,
 587                             unsigned long data5);
 588
 589 void W_DragSourceStartTimer(WMDraggingInfo *info);
 590
 591 void W_DragSourceStopTimer();
 592
 593 void W_DragSourceStateHandler(WMDraggingInfo *info, XClientMessageEvent *event);
 594
 595 void W_DragDestinationStartTimer(WMDraggingInfo *info);
 596
 597 void W_DragDestinationStopTimer();
 598
 599 void W_DragDestinationStoreEnterMsgInfo(WMDraggingInfo *info, WMView *toplevel,
 600                                         XClientMessageEvent *event);
 601
 602 void W_DragDestinationStorePositionMsgInfo(WMDraggingInfo *info,
 603                                            WMView *toplevel,
 604                                            XClientMessageEvent *event);
 605
 606 void W_DragDestinationCancelDropOnEnter(WMView *toplevel, WMDraggingInfo *info);
 607
 608 void W_DragDestinationStateHandler(WMDraggingInfo *info,
 609                                    XClientMessageEvent *event);
 610
 611 void W_DragDestinationInfoClear(WMDraggingInfo *info);
 612
 613 void W_FreeViewXdndPart(WMView *view);
 614
 615 #ifdef __cplusplus
 616 }
 617 #endif /* __cplusplus */
 618
 619 #endif /* _WINGSP_H_ */
 620