WINGs/WINGs.h

   1
   2
   3 #ifndef _WINGS_H_
   4 #define _WINGS_H_
   5
   6 #include <wraster.h>
   7 #include <WUtil.h>
   8 #include <X11/Xlib.h>
   9
  10 #define WINGS_H_VERSION  990516
  11
  12
  13 #ifdef __cplusplus
  14 extern "C" {
  15 #endif /* __cplusplus */
  16 #if 0
  17 }
  18 #endif
  19
  20
  21 typedef unsigned long WMPixel;
  22
  23
  24 typedef struct {
  25     unsigned int width;
  26     unsigned int height;
  27 } WMSize;
  28
  29 typedef struct {
  30     int x;
  31     int y;
  32 } WMPoint;
  33
  34 typedef struct {
  35     WMPoint pos;
  36     WMSize size;
  37 } WMRect;
  38
  39 typedef struct {
  40     int position;
  41     int count;
  42 } WMRange;
  43
  44
  45 #define ClientMessageMask       (1L<<30)
  46
  47
  48 /* window stacking level */
  49 enum {
  50   WMNormalWindowLevel   = 0,
  51   WMFloatingWindowLevel  = 3,
  52   WMDockWindowLevel   = 5,
  53   WMSubmenuWindowLevel  = 10,
  54   WMMainMenuWindowLevel  = 20
  55 };
  56
  57 /* window attributes */
  58 enum {
  59   WMBorderlessWindowMask = 0,
  60   WMTitledWindowMask = 1,
  61   WMClosableWindowMask = 2,
  62   WMMiniaturizableWindowMask = 4,
  63   WMResizableWindowMask = 8
  64 };
  65
  66
  67 /* button types */
  68 typedef enum {
  69     /* 0 is reserved for internal use */
  70         WBTMomentaryPush = 1,
  71         WBTPushOnPushOff = 2,
  72         WBTToggle = 3,
  73         WBTSwitch = 4,
  74         WBTRadio = 5,
  75         WBTMomentaryChange = 6,
  76         WBTOnOff = 7,
  77         WBTMomentaryLight = 8
  78 } WMButtonType;
  79
  80 /* button behaviour masks */
  81 enum {
  82     WBBSpringLoadedMask =       (1 << 0),
  83         WBBPushInMask =         (1 << 1),
  84         WBBPushChangeMask =     (1 << 2),
  85         WBBPushLightMask =      (1 << 3),
  86         WBBStateLightMask =     (1 << 5),
  87         WBBStateChangeMask =    (1 << 6),
  88         WBBStatePushMask =      (1 << 7)
  89 };
  90
  91
  92 /* frame title positions */
  93 typedef enum {
  94     WTPNoTitle,
  95         WTPAboveTop,
  96         WTPAtTop,
  97         WTPBelowTop,
  98         WTPAboveBottom,
  99         WTPAtBottom,
 100         WTPBelowBottom
 101 } WMTitlePosition;
 102
 103
 104 /* relief types */
 105 typedef enum {
 106     WRFlat,
 107         WRSimple,
 108         WRRaised,
 109         WRSunken,
 110         WRGroove,
 111         WRRidge,
 112         WRPushed
 113 } WMReliefType;
 114
 115
 116 /* alignment types */
 117 typedef enum {
 118     WALeft,
 119         WACenter,
 120         WARight,
 121         WAJustified                    /* not valid for textfields */
 122 } WMAlignment;
 123
 124
 125 /* image position */
 126 typedef enum {
 127     WIPNoImage,
 128     WIPImageOnly,
 129     WIPLeft,
 130     WIPRight,
 131     WIPBelow,
 132     WIPAbove,
 133     WIPOverlaps
 134 } WMImagePosition;
 135
 136
 137 /* scroller arrow position */
 138 typedef enum {
 139     WSAMaxEnd,
 140         WSAMinEnd,
 141         WSANone
 142 } WMScrollArrowPosition;
 143
 144 /* scroller parts */
 145 typedef enum {
 146     WSNoPart,
 147         WSDecrementPage,
 148         WSIncrementPage,
 149         WSDecrementLine,
 150         WSIncrementLine,
 151         WSKnob,
 152         WSKnobSlot
 153 } WMScrollerPart;
 154
 155 /* usable scroller parts */
 156 typedef enum {
 157     WSUNoParts,
 158         WSUOnlyArrows,
 159         WSUAllParts
 160 } WMUsableScrollerParts;
 161
 162 /* matrix types */
 163 typedef enum {
 164     WMRadioMode,
 165         WMHighlightMode,
 166         WMListMode,
 167         WMTrackMode
 168 } WMMatrixTypes;
 169
 170
 171 typedef enum {
 172     WTTopTabsBevelBorder,
 173         WTNoTabsBevelBorder,
 174         WTNoTabsLineBorder,
 175         WTNoTabsNoBorder
 176 } WMTabViewTypes;
 177
 178
 179 /* text movement types */
 180 enum {
 181     WMIllegalTextMovement,
 182         WMReturnTextMovement,
 183         WMTabTextMovement,
 184         WMBacktabTextMovement,
 185         WMLeftTextMovement,
 186         WMRightTextMovement,
 187         WMUpTextMovement,
 188         WMDownTextMovement
 189 };
 190
 191 /* text field special events */
 192 enum {
 193     WMInsertTextEvent,
 194     WMDeleteTextEvent
 195 };
 196
 197 typedef enum {
 198         WMGrayModeColorPanel,
 199         WMRGBModeColorPanel,
 200         WMCMYKModeColorPanel,
 201         WMHSBModeColorPanel,
 202         WMCustomPaletteModeColorPanel,
 203         WMColorListModeColorPanel,
 204         WMWheelModeColorPanel
 205 } WMColorPanelMode;
 206
 207
 208
 209 /* system images */
 210 #define WSIReturnArrow                  1
 211 #define WSIHighlightedReturnArrow       2
 212 #define WSIScrollerDimple               3
 213 #define WSIArrowLeft                    4
 214 #define WSIHighlightedArrowLeft         5
 215 #define WSIArrowRight                   6
 216 #define WSIHighlightedArrowRight        7
 217 #define WSIArrowUp                      8
 218 #define WSIHighlightedArrowUp           9
 219 #define WSIArrowDown                    10
 220 #define WSIHighlightedArrowDown         11
 221 #define WSICheckMark                    12
 222
 223 enum {
 224     WLDSSelected = (1 << 16),
 225         WLDSDisabled = (1 << 17),
 226         WLDSFocused = (1 << 18),
 227         WLDSIsBranch = (1 << 19)
 228 };
 229
 230 /* alert panel return values */
 231 enum {
 232     WAPRDefault = 0,
 233         WAPRAlternate = 1,
 234         WAPROther = -1,
 235         WAPRError = -2
 236 };
 237
 238
 239
 240 /* types of input observers */
 241 enum {
 242     WIReadMask = (1 << 0),
 243         WIWriteMask = (1 << 1),
 244         WIExceptMask = (1 << 2)
 245 };
 246
 247
 248
 249 typedef int W_Class;
 250
 251 enum {
 252     WC_Window = 0,
 253     WC_Frame = 1,
 254     WC_Label = 2,
 255     WC_Button = 3,
 256     WC_TextField = 4,
 257     WC_Scroller = 5,
 258     WC_ScrollView = 6,
 259     WC_List = 7,
 260     WC_Browser = 8,
 261     WC_PopUpButton = 9,
 262     WC_ColorWell = 10,
 263     WC_Slider = 11,
 264     WC_Matrix = 12,                    /* not ready */
 265     WC_SplitView = 13,
 266     WC_TabView = 14
 267 };
 268
 269 /* All widgets must start with the following structure
 270  * in that order. Used for typecasting to get some generic data */
 271 typedef struct W_WidgetType {
 272     W_Class widgetClass;
 273     struct W_View *view;
 274
 275 } W_WidgetType;
 276
 277
 278 #define WMWidgetClass(widget)   (((W_WidgetType*)(widget))->widgetClass)
 279 #define WMWidgetView(widget)    (((W_WidgetType*)(widget))->view)
 280
 281
 282 /* widgets */
 283
 284 typedef void WMWidget;
 285
 286 typedef struct W_Pixmap WMPixmap;
 287 typedef struct W_Font   WMFont;
 288 typedef struct W_Color  WMColor;
 289
 290 typedef struct W_Screen WMScreen;
 291
 292 typedef struct W_View WMView;
 293
 294 typedef struct W_Window WMWindow;
 295 typedef struct W_Frame WMFrame;
 296 typedef struct W_Button WMButton;
 297 typedef struct W_Label WMLabel;
 298 typedef struct W_TextField WMTextField;
 299 typedef struct W_Scroller WMScroller;
 300 typedef struct W_ScrollView WMScrollView;
 301 typedef struct W_List WMList;
 302 typedef struct W_Browser WMBrowser;
 303 typedef struct W_PopUpButton WMPopUpButton;
 304 typedef struct W_ColorWell WMColorWell;
 305 typedef struct W_Slider WMSlider;
 306 typedef struct W_Matrix WMMatrix;      /* not ready */
 307 typedef struct W_SplitView WMSplitView;
 308 typedef struct W_TabView WMTabView;
 309
 310 /* not widgets */
 311 typedef struct W_TabViewItem WMTabViewItem;
 312
 313
 314 typedef struct W_FilePanel WMFilePanel;
 315 typedef WMFilePanel WMOpenPanel;
 316 typedef WMFilePanel WMSavePanel;
 317
 318 typedef struct W_FontPanel WMFontPanel;
 319
 320 typedef struct W_ColorPanel WMColorPanel;
 321
 322
 323 /* item for WMList */
 324 typedef struct WMListItem {
 325     char *text;
 326     void *clientData;                  /* ptr for user clientdata. */
 327
 328     struct WMListItem *nextPtr;
 329
 330     unsigned int uflags:16;            /* flags for the user */
 331     unsigned int selected:1;
 332     unsigned int disabled:1;
 333     unsigned int isBranch:1;
 334     unsigned int loaded:1;
 335 } WMListItem;
 336
 337 /* struct for message panel */
 338 typedef struct WMAlertPanel {
 339     WMWindow *win;                     /* window */
 340     WMButton *defBtn;                  /* default button */
 341     WMButton *altBtn;                  /* alternative button */
 342     WMButton *othBtn;                  /* other button */
 343     WMLabel *iLbl;                     /* icon label */
 344     WMLabel *tLbl;                     /* title label */
 345     WMLabel *mLbl;                     /* message label */
 346     WMFrame *line;                     /* separator */
 347     short result;                      /* button that was pushed */
 348     short done;
 349
 350     KeyCode retKey;
 351 } WMAlertPanel;
 352
 353
 354 typedef struct WMInputPanel {
 355     WMWindow *win;                     /* window */
 356     WMButton *defBtn;                  /* default button */
 357     WMButton *altBtn;                  /* alternative button */
 358     WMLabel *tLbl;                     /* title label */
 359     WMLabel *mLbl;                     /* message label */
 360     WMTextField *text;                 /* text field */
 361     short result;                      /* button that was pushed */
 362     short done;
 363
 364     KeyCode retKey;
 365 } WMInputPanel;
 366
 367
 368
 369
 370
 371
 372
 373 typedef void *WMHandlerID;
 374
 375 typedef void WMInputProc(int fd, int mask, void *clientData);
 376
 377 typedef void WMEventProc(XEvent *event, void *clientData);
 378
 379 typedef void WMEventHook(XEvent *event);
 380
 381 /* self is set to the widget from where the callback is being called and
 382  * clientData to the data set to with WMSetClientData() */
 383 typedef void WMAction(WMWidget *self, void *clientData);
 384
 385 /* same as WMAction, but for stuff that arent widgets */
 386 typedef void WMAction2(void *self, void *clientData);
 387
 388 typedef void WMCallback(void *data);
 389
 390
 391 /* delegate method like stuff */
 392 typedef void WMFreeDataProc(void *data);
 393
 394 typedef void WMListDrawProc(WMList *lPtr, int index, Drawable d, char *text,
 395                             int state, WMRect *rect);
 396
 397 /*
 398 typedef void WMSplitViewResizeSubviewsProc(WMSplitView *sPtr,
 399                                            unsigned int oldWidth,
 400                                            unsigned int oldHeight);
 401 */
 402
 403 typedef void WMSplitViewConstrainProc(WMSplitView *sPtr, int dividerIndex,
 404                                       int *minCoordinate, int *maxCoordinate);
 405
 406 typedef WMWidget *WMMatrixCreateCellProc(WMMatrix *mPtr);
 407
 408
 409 typedef Bool WMConvertSelectionProc(WMWidget *w, Atom selection, Atom target,
 410                                     Atom *type, void **value, unsigned *length,
 411                                     int *format);
 412
 413 typedef void WMLoseSelectionProc(WMWidget *w, Atom selection);
 414
 415 typedef void WMSelectionDoneProc(WMWidget *w, Atom selection, Atom target);
 416
 417
 418
 419
 420 typedef struct WMBrowserDelegate {
 421     void *data;
 422
 423     void (*createRowsForColumn)(struct WMBrowserDelegate *self,
 424                                 WMBrowser *sender, int column, WMList *list);
 425
 426     char* (*titleOfColumn)(struct WMBrowserDelegate *self, WMBrowser *sender,
 427                            int column);
 428
 429     void (*didScroll)(struct WMBrowserDelegate *self, WMBrowser *sender);
 430
 431     void (*willScroll)(struct WMBrowserDelegate *self, WMBrowser *sender);
 432 } WMBrowserDelegate;
 433
 434
 435 typedef struct WMTextFieldDelegate {
 436     void *data;
 437
 438     void (*didBeginEditing)(struct WMTextFieldDelegate *self,
 439                             WMNotification *notif);
 440
 441     void (*didChange)(struct WMTextFieldDelegate *self,
 442                       WMNotification *notif);
 443
 444     void (*didEndEditing)(struct WMTextFieldDelegate *self,
 445                           WMNotification *notif);
 446
 447     Bool (*shouldBeginEditing)(struct WMTextFieldDelegate *self,
 448                                WMTextField *tPtr);
 449
 450     Bool (*shouldEndEditing)(struct WMTextFieldDelegate *self,
 451                              WMTextField *tPtr);
 452 } WMTextFieldDelegate;
 453
 454
 455
 456 typedef struct WMTabViewDelegate {
 457     void *data;
 458
 459     void (*didChangeNumberOfItems)(struct WMTabViewDelegate *self,
 460                                    WMTabView *tabView);
 461
 462     void (*didSelectItem)(struct WMTabViewDelegate *self, WMTabView *tabView,
 463                                  WMTabViewItem *item);
 464
 465     Bool (*shouldSelectItem)(struct WMTabViewDelegate *self, WMTabView *tabView,
 466                              WMTabViewItem *item);
 467
 468     void (*willSelectItem)(struct WMTabViewDelegate *self, WMTabView *tabView,
 469                            WMTabViewItem *item);
 470 } WMTabViewDelegate;
 471
 472
 473
 474 /* ....................................................................... */
 475
 476
 477
 478 void WMInitializeApplication(char *applicationName, int *argc, char **argv);
 479
 480 void WMSetApplicationDataPath(char *path);
 481
 482 /* don't free the returned string */
 483 char *WMGetApplicationName();
 484
 485 /* Try to locate resource file. ext may be NULL */
 486 char *WMPathForResourceOfType(char *resource, char *ext);
 487
 488 WMScreen *WMCreateScreenWithRContext(Display *display, int screen,
 489                                      RContext *context);
 490
 491 WMScreen *WMCreateScreen(Display *display, int screen);
 492
 493 WMScreen *WMCreateSimpleApplicationScreen(Display *display);
 494
 495 void WMScreenMainLoop(WMScreen *scr);
 496
 497
 498 RContext *WMScreenRContext(WMScreen *scr);
 499
 500 Display *WMScreenDisplay(WMScreen *scr);
 501
 502 int WMScreenDepth(WMScreen *scr);
 503
 504
 505
 506 void WMSetApplicationIconImage(WMScreen *app, WMPixmap *icon);
 507
 508 WMPixmap *WMGetApplicationIconImage(WMScreen *app);
 509
 510 void WMSetFocusToWidget(WMWidget *widget);
 511
 512 WMEventHook *WMHookEventHandler(WMEventHook *handler);
 513
 514 int WMHandleEvent(XEvent *event);
 515
 516 Bool WMScreenPending(WMScreen *scr);
 517
 518 void WMCreateEventHandler(WMView *view, unsigned long mask,
 519                           WMEventProc *eventProc, void *clientData);
 520
 521 void WMDeleteEventHandler(WMView *view, unsigned long mask,
 522                           WMEventProc *eventProc, void *clientData);
 523
 524 int WMIsDoubleClick(XEvent *event);
 525
 526 void WMNextEvent(Display *dpy, XEvent *event);
 527
 528 void WMMaskEvent(Display *dpy, long mask, XEvent *event);
 529
 530 WMHandlerID WMAddTimerHandler(int milliseconds, WMCallback *callback,
 531                               void *cdata);
 532
 533 void WMDeleteTimerWithClientData(void *cdata);
 534
 535 void WMDeleteTimerHandler(WMHandlerID handlerID);
 536
 537 WMHandlerID WMAddIdleHandler(WMCallback *callback, void *cdata);
 538
 539 void WMDeleteIdleHandler(WMHandlerID handlerID);
 540
 541 WMHandlerID WMAddInputHandler(int fd, int condition, WMInputProc *proc,
 542                               void *clientData);
 543
 544 void WMDeleteInputHandler(WMHandlerID handlerID);
 545
 546 /* ....................................................................... */
 547 /*
 548 void WMDragImageFromView(WMView *view, WMPixmap *image, WMPoint atLocation,
 549                          WMSize mouseOffset, XEvent *event, Bool slideBack);
 550
 551 */
 552
 553 /* ....................................................................... */
 554
 555 WMFont *WMCreateFont(WMScreen *scrPtr, char *fontName);
 556
 557 WMFont *WMCreateFontInDefaultEncoding(WMScreen *scrPtr, char *fontName);
 558
 559 WMFont *WMRetainFont(WMFont *font);
 560
 561 void WMReleaseFont(WMFont *font);
 562
 563 unsigned int WMFontHeight(WMFont *font);
 564
 565 /*
 566 WMFont *WMUserFontOfSize(WMScreen *scrPtr, int size);
 567
 568 WMFont *WMUserFixedPitchFontOfSize(WMScreen *scrPtr, int size);
 569 */
 570
 571 WMFont *WMSystemFontOfSize(WMScreen *scrPtr, int size);
 572
 573 WMFont *WMBoldSystemFontOfSize(WMScreen *scrPtr, int size);
 574
 575 XFontSet WMGetFontFontSet(WMFont *font);
 576
 577 /* ....................................................................... */
 578
 579 WMPixmap *WMRetainPixmap(WMPixmap *pixmap);
 580
 581 void WMReleasePixmap(WMPixmap *pixmap);
 582
 583 WMPixmap *WMCreatePixmap(WMScreen *scrPtr, int width, int height, int depth,
 584                          Bool masked);
 585
 586 WMPixmap *WMCreatePixmapFromXPixmaps(WMScreen *scrPtr, Pixmap pixmap,
 587                                      Pixmap mask, int width, int height,
 588                                      int depth);
 589
 590 WMPixmap *WMCreatePixmapFromRImage(WMScreen *scrPtr, RImage *image,
 591                                    int threshold);
 592
 593 WMPixmap *WMCreatePixmapFromXPMData(WMScreen *scrPtr, char **data);
 594
 595 WMSize WMGetPixmapSize(WMPixmap *pixmap);
 596
 597 WMPixmap *WMCreatePixmapFromFile(WMScreen *scrPtr, char *fileName);
 598
 599 WMPixmap *WMCreateBlendedPixmapFromFile(WMScreen *scrPtr, char *fileName,
 600                                         RColor *color);
 601
 602 void WMDrawPixmap(WMPixmap *pixmap, Drawable d, int x, int y);
 603
 604 Pixmap WMGetPixmapXID(WMPixmap *pixmap);
 605
 606 Pixmap WMGetPixmapMaskXID(WMPixmap *pixmap);
 607
 608 WMPixmap *WMGetSystemPixmap(WMScreen *scr, int image);
 609
 610 /* ....................................................................... */
 611
 612
 613 WMColor *WMDarkGrayColor(WMScreen *scr);
 614
 615 WMColor *WMGrayColor(WMScreen *scr);
 616
 617 WMColor *WMBlackColor(WMScreen *scr);
 618
 619 WMColor *WMWhiteColor(WMScreen *scr);
 620
 621 void WMSetColorInGC(WMColor *color, GC gc);
 622
 623 GC WMColorGC(WMColor *color);
 624
 625 WMPixel WMColorPixel(WMColor *color);
 626
 627 void WMPaintColorSwatch(WMColor *color, Drawable d, int x, int y,
 628                         unsigned int width, unsigned int height);
 629
 630 void WMReleaseColor(WMColor *color);
 631
 632 WMColor *WMRetainColor(WMColor *color);
 633
 634 WMColor *WMCreateRGBColor(WMScreen *scr, unsigned short red,
 635                           unsigned short green, unsigned short blue,
 636                           Bool exact);
 637
 638 WMColor *WMCreateNamedColor(WMScreen *scr, char *name, Bool exact);
 639
 640 unsigned short WMRedComponentOfColor(WMColor *color);
 641
 642 unsigned short WMGreenComponentOfColor(WMColor *color);
 643
 644 unsigned short WMBlueComponentOfColor(WMColor *color);
 645
 646 char *WMGetColorRGBDescription(WMColor *color);
 647
 648 /* ....................................................................... */
 649
 650
 651 void WMDrawString(WMScreen *scr, Drawable d, GC gc, WMFont *font, int x,
 652                   int y, char *text, int length);
 653
 654 void WMDrawImageString(WMScreen *scr, Drawable d, GC gc, WMFont *font, int x,
 655                        int y, char *text, int length);
 656
 657 int WMWidthOfString(WMFont *font, char *text, int length);
 658
 659
 660
 661 /* ....................................................................... */
 662
 663 WMScreen *WMWidgetScreen(WMWidget *w);
 664
 665 void WMUnmapWidget(WMWidget *w);
 666
 667 void WMMapWidget(WMWidget *w);
 668
 669 void WMMoveWidget(WMWidget *w, int x, int y);
 670
 671 void WMResizeWidget(WMWidget *w, unsigned int width, unsigned int height);
 672
 673 void WMSetWidgetBackgroundColor(WMWidget *w, WMColor *color);
 674
 675 void WMMapSubwidgets(WMWidget *w);
 676
 677 void WMUnmapSubwidgets(WMWidget *w);
 678
 679 void WMRealizeWidget(WMWidget *w);
 680
 681 void WMDestroyWidget(WMWidget *widget);
 682
 683 void WMHangData(WMWidget *widget, void *data);
 684
 685 void *WMGetHangedData(WMWidget *widget);
 686
 687 unsigned int WMWidgetWidth(WMWidget *w);
 688
 689 unsigned int WMWidgetHeight(WMWidget *w);
 690
 691 Window WMWidgetXID(WMWidget *w);
 692
 693 Window WMViewXID(WMView *view);
 694
 695 void WMRedisplayWidget(WMWidget *w);
 696
 697 void WMSetViewNotifySizeChanges(WMView *view, Bool flag);
 698
 699 WMSize WMGetViewSize(WMView *view);
 700
 701 WMPoint WMGetViewPosition(WMView *view);
 702
 703 WMWidget *WMWidgetOfView(WMView *view);
 704
 705 /* notifications */
 706 extern char *WMViewSizeDidChangeNotification;
 707
 708 extern char *WMViewRealizedNotification;
 709
 710
 711 /* ....................................................................... */
 712
 713 void WMSetBalloonTextForView(char *text, WMView *view);
 714
 715 void WMSetBalloonTextAlignment(WMScreen *scr, WMAlignment alignment);
 716
 717 void WMSetBalloonFont(WMScreen *scr, WMFont *font);
 718
 719 void WMSetBalloonTextColor(WMScreen *scr, WMColor *color);
 720
 721 void WMSetBalloonDelay(WMScreen *scr, int delay);
 722
 723 void WMSetBalloonEnabled(WMScreen *scr, Bool flag);
 724
 725
 726 /* ....................................................................... */
 727
 728 WMWindow *WMCreateWindow(WMScreen *screen, char *name);
 729
 730 WMWindow *WMCreateWindowWithStyle(WMScreen *screen, char *name, int style);
 731
 732 WMWindow *WMCreatePanelWithStyleForWindow(WMWindow *owner, char *name,
 733                                           int style);
 734
 735 WMWindow *WMCreatePanelForWindow(WMWindow *owner, char *name);
 736
 737 void WMChangePanelOwner(WMWindow *win, WMWindow *newOwner);
 738
 739 void WMSetWindowTitle(WMWindow *wPtr, char *title);
 740
 741 void WMSetWindowMiniwindowTitle(WMWindow *win, char *title);
 742
 743 void WMSetWindowMiniwindowImage(WMWindow *win, WMPixmap *pixmap);
 744
 745 void WMSetWindowCloseAction(WMWindow *win, WMAction *action, void *clientData);
 746
 747 void WMSetWindowUPosition(WMWindow *win, int x, int y);
 748
 749 void WMSetWindowUSize(WMWindow *win, unsigned width, unsigned height);
 750
 751 void WMSetWindowMaxSize(WMWindow *win, unsigned width, unsigned height);
 752
 753 void WMSetWindowMinSize(WMWindow *win, unsigned width, unsigned height);
 754
 755 void WMSetWindowBaseSize(WMWindow *win, unsigned width, unsigned height);
 756
 757 void WMSetWindowResizeIncrements(WMWindow *win, unsigned wIncr, unsigned hIncr);
 758
 759 void WMSetWindowLevel(WMWindow *win, int level);
 760
 761 void WMSetWindowDocumentEdited(WMWindow *win, Bool flag);
 762
 763 void WMCloseWindow(WMWindow *win);
 764
 765 /* ....................................................................... */
 766
 767 void WMSetButtonAction(WMButton *bPtr, WMAction *action, void *clientData);
 768
 769 #define WMCreateCommandButton(parent) \
 770         WMCreateCustomButton((parent), WBBSpringLoadedMask\
 771                                         |WBBPushInMask\
 772                                         |WBBPushLightMask\
 773                                         |WBBPushChangeMask)
 774
 775 #define WMCreateRadioButton(parent) \
 776         WMCreateButton((parent), WBTRadio)
 777
 778 #define WMCreateSwitchButton(parent) \
 779         WMCreateButton((parent), WBTSwitch)
 780
 781 WMButton *WMCreateButton(WMWidget *parent, WMButtonType type);
 782
 783 WMButton *WMCreateCustomButton(WMWidget *parent, int behaviourMask);
 784
 785 void WMSetButtonImage(WMButton *bPtr, WMPixmap *image);
 786
 787 void WMSetButtonAltImage(WMButton *bPtr, WMPixmap *image);
 788
 789 void WMSetButtonImagePosition(WMButton *bPtr, WMImagePosition position);
 790
 791 void WMSetButtonFont(WMButton *bPtr, WMFont *font);
 792
 793 void WMSetButtonTextAlignment(WMButton *bPtr, WMAlignment alignment);
 794
 795 void WMSetButtonText(WMButton *bPtr, char *text);
 796
 797 void WMSetButtonAltText(WMButton *bPtr, char *text);
 798
 799 void WMSetButtonSelected(WMButton *bPtr, int isSelected);
 800
 801 int WMGetButtonSelected(WMButton *bPtr);
 802
 803 void WMSetButtonBordered(WMButton *bPtr, int isBordered);
 804
 805 void WMSetButtonEnabled(WMButton *bPtr, Bool flag);
 806
 807 void WMSetButtonImageDimsWhenDisabled(WMButton *bPtr, Bool flag);
 808
 809 void WMSetButtonTag(WMButton *bPtr, int tag);
 810
 811 void WMGroupButtons(WMButton *bPtr, WMButton *newMember);
 812
 813 void WMPerformButtonClick(WMButton *bPtr);
 814
 815 void WMSetButtonContinuous(WMButton *bPtr, Bool flag);
 816
 817 void WMSetButtonPeriodicDelay(WMButton *bPtr, float delay, float interval);
 818
 819 /* ....................................................................... */
 820
 821 WMLabel *WMCreateLabel(WMWidget *parent);
 822
 823 void WMSetLabelWraps(WMLabel *lPtr, Bool flag);
 824
 825 void WMSetLabelImage(WMLabel *lPtr, WMPixmap *image);
 826
 827 WMPixmap *WMGetLabelImage(WMLabel *lPtr);
 828
 829 void WMSetLabelImagePosition(WMLabel *lPtr, WMImagePosition position);
 830
 831 void WMSetLabelTextAlignment(WMLabel *lPtr, WMAlignment alignment);
 832
 833 void WMSetLabelRelief(WMLabel *lPtr, WMReliefType relief);
 834
 835 void WMSetLabelText(WMLabel *lPtr, char *text);
 836
 837 void WMSetLabelFont(WMLabel *lPtr, WMFont *font);
 838
 839 void WMSetLabelTextColor(WMLabel *lPtr, WMColor *color);
 840
 841 /* ....................................................................... */
 842
 843 WMFrame *WMCreateFrame(WMWidget *parent);
 844
 845 void WMSetFrameTitlePosition(WMFrame *fPtr, WMTitlePosition position);
 846
 847 void WMSetFrameRelief(WMFrame *fPtr, WMReliefType relief);
 848
 849 void WMSetFrameTitle(WMFrame *fPtr, char *title);
 850
 851 /* ....................................................................... */
 852
 853 WMTextField *WMCreateTextField(WMWidget *parent);
 854
 855 void WMInsertTextFieldText(WMTextField *tPtr, char *text, int position);
 856
 857 void WMDeleteTextFieldRange(WMTextField *tPtr, WMRange range);
 858
 859 /* you can free the returned string */
 860 char *WMGetTextFieldText(WMTextField *tPtr);
 861
 862 void WMSetTextFieldText(WMTextField *tPtr, char *text);
 863
 864 void WMSetTextFieldAlignment(WMTextField *tPtr, WMAlignment alignment);
 865
 866 void WMSetTextFieldBordered(WMTextField *tPtr, Bool bordered);
 867
 868 void WMSetTextFieldBeveled(WMTextField *tPtr, Bool flag);
 869
 870 Bool WMGetTextFieldEditable(WMTextField *tPtr);
 871
 872 void WMSetTextFieldEditable(WMTextField *tPtr, Bool flag);
 873
 874 void WMSetTextFieldSecure(WMTextField *tPtr, Bool flag);
 875
 876 void WMSelectTextFieldRange(WMTextField *tPtr, WMRange range);
 877
 878 void WMSetTextFieldCursorPosition(WMTextField *tPtr, unsigned int position);
 879
 880 void WMSetTextFieldNextTextField(WMTextField *tPtr, WMTextField *next);
 881
 882 void WMSetTextFieldPrevTextField(WMTextField *tPtr, WMTextField *prev);
 883
 884 void WMSetTextFieldDelegate(WMTextField *tPtr, WMTextFieldDelegate *delegate);
 885
 886
 887 extern char *WMTextDidChangeNotification;
 888 extern char *WMTextDidBeginEditingNotification;
 889 extern char *WMTextDidEndEditingNotification;
 890
 891 /* ....................................................................... */
 892
 893 WMScroller *WMCreateScroller(WMWidget *parent);
 894
 895 void WMSetScrollerParameters(WMScroller *sPtr, float floatValue,
 896                              float knobProportion);
 897
 898 float WMGetScrollerKnobProportion(WMScroller *sPtr);
 899
 900 float WMGetScrollerValue(WMScroller *sPtr);
 901
 902 WMScrollerPart WMGetScrollerHitPart(WMScroller *sPtr);
 903
 904 void WMSetScrollerAction(WMScroller *sPtr, WMAction *action, void *clientData);
 905
 906 void WMSetScrollerArrowsPosition(WMScroller *sPtr,
 907                                  WMScrollArrowPosition position);
 908
 909 /* ....................................................................... */
 910
 911 WMList *WMCreateList(WMWidget *parent);
 912
 913 #define WMAddListItem(lPtr, text) WMInsertListItem((lPtr), -1, (text))
 914
 915 WMListItem *WMInsertListItem(WMList *lPtr, int row, char *text);
 916
 917 WMListItem *WMAddSortedListItem(WMList *lPtr, char *text);
 918
 919 int WMFindRowOfListItemWithTitle(WMList *lPtr, char *title);
 920
 921 WMListItem *WMGetListItem(WMList *lPtr, int row);
 922
 923 void WMRemoveListItem(WMList *lPtr, int row);
 924
 925 void WMSelectListItem(WMList *lPtr, int row);
 926
 927 void WMSetListUserDrawProc(WMList *lPtr, WMListDrawProc *proc);
 928
 929 void WMSetListUserDrawItemHeight(WMList *lPtr, unsigned short height);
 930
 931 int WMGetListItemHeight(WMList *lPtr);
 932
 933 /* don't free the returned data */
 934 WMListItem *WMGetListSelectedItem(WMList *lPtr);
 935
 936 int WMGetListSelectedItemRow(WMList *lPtr);
 937
 938 void WMSetListAction(WMList *lPtr, WMAction *action, void *clientData);
 939
 940 void WMSetListDoubleAction(WMList *lPtr, WMAction *action, void *clientData);
 941
 942 void WMClearList(WMList *lPtr);
 943
 944 int WMGetListNumberOfRows(WMList *lPtr);
 945
 946 void WMSetListPosition(WMList *lPtr, int row);
 947
 948 void WMSetListBottomPosition(WMList *lPtr, int row);
 949
 950 int WMGetListPosition(WMList *lPtr);
 951
 952 extern char *WMListDidScrollNotification;
 953 extern char *WMListSelectionDidChangeNotification;
 954
 955 /* ....................................................................... */
 956
 957 WMBrowser *WMCreateBrowser(WMWidget *parent);
 958
 959 void WMSetBrowserPathSeparator(WMBrowser *bPtr, char *separator);
 960
 961 void WMSetBrowserTitled(WMBrowser *bPtr, Bool flag);
 962
 963 void WMLoadBrowserColumnZero(WMBrowser *bPtr);
 964
 965 int WMAddBrowserColumn(WMBrowser *bPtr);
 966
 967 void WMRemoveBrowserItem(WMBrowser *bPtr, int column, int row);
 968
 969 void WMSetBrowserMaxVisibleColumns(WMBrowser *bPtr, int columns);
 970
 971 void WMSetBrowserColumnTitle(WMBrowser *bPtr, int column, char *title);
 972
 973 WMListItem *WMAddSortedBrowserItem(WMBrowser *bPtr, int column, char *text, Bool isBranch);
 974
 975 WMListItem *WMInsertBrowserItem(WMBrowser *bPtr, int column, int row, char *text, Bool isBranch);
 976
 977 /* Don't free the returned string. */
 978 char* WMSetBrowserPath(WMBrowser *bPtr, char *path);
 979
 980 /* you can free the returned string */
 981 char *WMGetBrowserPath(WMBrowser *bPtr);
 982 /* you can free the returned string */
 983 char *WMGetBrowserPathToColumn(WMBrowser *bPtr, int column);
 984
 985 void WMSetBrowserAction(WMBrowser *bPtr, WMAction *action, void *clientData);
 986
 987 void WMSetBrowserDoubleAction(WMBrowser *bPtr, WMAction *action,
 988                               void *clientData);
 989
 990 WMListItem *WMGetBrowserSelectedItemInColumn(WMBrowser *bPtr, int column);
 991
 992 int WMGetBrowserFirstVisibleColumn(WMBrowser *bPtr);
 993
 994 int WMGetBrowserSelectedColumn(WMBrowser *bPtr);
 995
 996 int WMGetBrowserSelectedRowInColumn(WMBrowser *bPtr, int column);
 997
 998 int WMGetBrowserNumberOfColumns(WMBrowser *bPtr);
 999
1000 int WMGetBrowserMaxVisibleColumns(WMBrowser *bPtr);
1001
1002 WMList *WMGetBrowserListInColumn(WMBrowser *bPtr, int column);
1003
1004 void WMSetBrowserDelegate(WMBrowser *bPtr, WMBrowserDelegate *delegate);
1005
1006 /* ....................................................................... */
1007
1008 WMPopUpButton *WMCreatePopUpButton(WMWidget *parent);
1009
1010 void WMSetPopUpButtonAction(WMPopUpButton *sPtr, WMAction *action,
1011                             void *clientData);
1012
1013 void WMSetPopUpButtonPullsDown(WMPopUpButton *bPtr, Bool flag);
1014
1015 void WMAddPopUpButtonItem(WMPopUpButton *bPtr, char *title);
1016
1017 void WMInsertPopUpButtonItem(WMPopUpButton *bPtr, int index, char *title);
1018
1019 void WMRemovePopUpButtonItem(WMPopUpButton *bPtr, int index);
1020
1021 void WMSetPopUpButtonItemEnabled(WMPopUpButton *bPtr, int index, Bool flag);
1022
1023 Bool WMGetPopUpButtonItemEnabled(WMPopUpButton *bPtr, int index);
1024
1025 void WMSetPopUpButtonSelectedItem(WMPopUpButton *bPtr, int index);
1026
1027 int WMGetPopUpButtonSelectedItem(WMPopUpButton *bPtr);
1028
1029 void WMSetPopUpButtonText(WMPopUpButton *bPtr, char *text);
1030
1031 /* don't free the returned data */
1032 char *WMGetPopUpButtonItem(WMPopUpButton *bPtr, int index);
1033
1034 int WMGetPopUpButtonNumberOfItems(WMPopUpButton *bPtr);
1035
1036 void WMSetPopUpButtonEnabled(WMPopUpButton *bPtr, Bool flag);
1037
1038 Bool WMGetPopUpButtonEnabled(WMPopUpButton *bPtr);
1039
1040 /* ....................................................................... */
1041
1042 WMColorPanel *WMGetColorPanel(WMScreen *scrPtr);
1043
1044 void WMFreeColorPanel(WMColorPanel *panel);
1045
1046 void WMShowColorPanel(WMColorPanel *panel);
1047
1048 void WMCloseColorPanel(WMColorPanel *panel);
1049
1050 void WMSetColorPanelColor(WMColorPanel *panel, WMColor *color);
1051
1052 WMColor *WMGetColorPanelColor(WMColorPanel *panel);
1053
1054 void WMSetColorPanelPickerMode(WMColorPanel *panel, WMColorPanelMode mode);
1055
1056 void WMSetColorPanelAction(WMColorPanel *panel, WMAction2 *action, void *data);
1057
1058 extern char *WMColorPanelColorChangedNotification;
1059
1060 /* ....................................................................... */
1061
1062 WMColorWell *WMCreateColorWell(WMWidget *parent);
1063
1064 void WMSetColorWellColor(WMColorWell *cPtr, WMColor *color);
1065
1066 WMColor *WMGetColorWellColor(WMColorWell *cPtr);
1067
1068 void WSetColorWellBordered(WMColorWell *cPtr, Bool flag);
1069
1070
1071 extern char *WMColorWellDidChangeNotification;
1072
1073
1074 /* ...................................................................... */
1075
1076 WMScrollView *WMCreateScrollView(WMWidget *parent);
1077
1078 void WMResizeScrollViewContent(WMScrollView *sPtr, unsigned int width,
1079                                unsigned int height);
1080
1081 void WMSetScrollViewHasHorizontalScroller(WMScrollView *sPtr, Bool flag);
1082
1083 void WMSetScrollViewHasVerticalScroller(WMScrollView *sPtr, Bool flag);
1084
1085 void WMSetScrollViewContentView(WMScrollView *sPtr, WMView *view);
1086
1087 void WMSetScrollViewRelief(WMScrollView *sPtr, WMReliefType type);
1088
1089 void WMSetScrollViewContentView(WMScrollView *sPtr, WMView *view);
1090
1091 WMScroller *WMGetScrollViewHorizontalScroller(WMScrollView *sPtr);
1092
1093 WMScroller *WMGetScrollViewVerticalScroller(WMScrollView *sPtr);
1094
1095 void WMSetScrollViewLineScroll(WMScrollView *sPtr, int amount);
1096
1097 void WMSetScrollViewPageScroll(WMScrollView *sPtr, int amount);
1098
1099 /* ....................................................................... */
1100
1101 WMSlider *WMCreateSlider(WMWidget *parent);
1102
1103 int WMGetSliderMinValue(WMSlider *slider);
1104
1105 int WMGetSliderMaxValue(WMSlider *slider);
1106
1107 int WMGetSliderValue(WMSlider *slider);
1108
1109 void WMSetSliderMinValue(WMSlider *slider, int value);
1110
1111 void WMSetSliderMaxValue(WMSlider *slider, int value);
1112
1113 void WMSetSliderValue(WMSlider *slider, int value);
1114
1115 void WMSetSliderContinuous(WMSlider *slider, Bool flag);
1116
1117 void WMSetSliderAction(WMSlider *slider, WMAction *action, void *data);
1118
1119 void WMSetSliderKnobThickness(WMSlider *sPtr, int thickness);
1120
1121 void WMSetSliderImage(WMSlider *sPtr, WMPixmap *pixmap);
1122
1123 /* ....................................................................... */
1124
1125 /* only supports 2 subviews */
1126 WMSplitView *WMCreateSplitView(WMWidget *parent);
1127
1128 void WMAddSplitViewSubview(WMSplitView *sPtr, WMView *subview);
1129
1130 void WMAdjustSplitViewSubviews(WMSplitView *sPtr);
1131
1132 void WMSetSplitViewConstrainProc(WMSplitView *sPtr,
1133                                  WMSplitViewConstrainProc *proc);
1134
1135 /*
1136 void WMSetSplitViewResizeSubviewsProc(WMSplitView *sPtr,
1137                                       WMSplitViewResizeSubviewsProc *proc);
1138 */
1139
1140 int WMGetSplitViewDividerThickness(WMSplitView *sPtr);
1141
1142
1143 /* ....................................................................... */
1144
1145
1146 WMTabView *WMCreateTabView(WMWidget *parent);
1147
1148 void WMSetTabViewFont(WMTabView *tPtr, WMFont *font);
1149
1150 void WMAddItemInTabView(WMTabView *tPtr, WMTabViewItem *item);
1151
1152 void WMInsertItemInTabView(WMTabView *tPtr, int index, WMTabViewItem *item);
1153
1154 void WMRemoveTabViewItem(WMTabView *tPtr, WMTabViewItem *item);
1155
1156 WMTabViewItem *WMTabViewItemAtPoint(WMTabView *tPtr, int x, int y);
1157
1158 void WMSelectFirstTabViewItem(WMTabView *tPtr);
1159
1160 void WMSelectLastTabViewItem(WMTabView *tPtr);
1161
1162 void WMSelectNextTabViewItem(WMTabView *tPtr);
1163
1164 void WMSelectPreviousTabViewItem(WMTabView *tPtr);
1165
1166 WMTabViewItem *WMGetSelectedTabViewItem(WMTabView *tPtr);
1167
1168 void WMSelectTabViewItem(WMTabView *tPtr, WMTabViewItem *item);
1169
1170 void WMSelectTabViewItemAtIndex(WMTabView *tPtr, int index);
1171
1172 void WMSetTabViewDelegate(WMTabView *tPtr, WMTabViewDelegate *delegate);
1173
1174
1175 WMTabViewItem *WMCreateTabViewItemWithIdentifier(int identifier);
1176
1177 int WMGetTabViewItemIdentifier(WMTabViewItem *item);
1178
1179 void WMSetTabViewItemLabel(WMTabViewItem *item, char *label);
1180
1181 char *WMGetTabViewItemLabel(WMTabViewItem *item);
1182
1183 void WMSetTabViewItemView(WMTabViewItem *item, WMView *view);
1184
1185 WMView *WMGetTabViewItemView(WMTabViewItem *item);
1186
1187 void WMDestroyTabViewItem(WMTabViewItem *item);
1188
1189 /* ....................................................................... */
1190
1191 int WMRunAlertPanel(WMScreen *app, WMWindow *owner, char *title, char *msg,
1192                     char *defaultButton, char *alternateButton,
1193                     char *otherButton);
1194
1195 /* you can free the returned string */
1196 char *WMRunInputPanel(WMScreen *app, WMWindow *owner, char *title, char *msg,
1197                       char *defaultText, char *okButton, char *cancelButton);
1198
1199 WMAlertPanel *WMCreateAlertPanel(WMScreen *app, WMWindow *owner, char *title,
1200                                  char *msg, char *defaultButton,
1201                                  char *alternateButton, char *otherButton);
1202
1203 WMInputPanel *WMCreateInputPanel(WMScreen *app, WMWindow *owner, char *title,
1204                                  char *msg, char *defaultText, char *okButton,
1205                                  char *cancelButton);
1206
1207 void WMDestroyAlertPanel(WMAlertPanel *panel);
1208
1209 void WMDestroyInputPanel(WMInputPanel *panel);
1210
1211 /* ....................................................................... */
1212
1213 /* only 1 instance per WMScreen */
1214 WMOpenPanel *WMGetOpenPanel(WMScreen *scrPtr);
1215
1216 WMSavePanel *WMGetSavePanel(WMScreen *scrPtr);
1217
1218 void WMSetFilePanelCanChooseDirectories(WMFilePanel *panel, Bool flag);
1219
1220 void WMSetFilePanelCanChooseFiles(WMFilePanel *panel, Bool flag);
1221
1222 void WMSetFilePanelAutoCompletion(WMFilePanel *panel, Bool flag);
1223
1224 void WMSetFilePanelDirectory(WMFilePanel *panel, char *path);
1225
1226 /* you can free the returned string */
1227 char *WMGetFilePanelFileName(WMFilePanel *panel);
1228
1229 void WMFreeFilePanel(WMFilePanel *panel);
1230
1231 int WMRunModalFilePanelForDirectory(WMFilePanel *panel, WMWindow *owner,
1232                                     char *path, char *name, char **fileTypes);
1233
1234 void WMSetFilePanelAccessoryView(WMFilePanel *panel, WMView *view);
1235
1236 WMView *WMGetFilePanelAccessoryView(WMFilePanel *panel);
1237
1238
1239 /* ...................................................................... */
1240
1241 /* only 1 instance per WMScreen */
1242 WMFontPanel *WMGetFontPanel(WMScreen *scr);
1243
1244 void WMShowFontPanel(WMFontPanel *panel);
1245
1246 void WMHideFontPanel(WMFontPanel *panel);
1247
1248 void WMSetFontPanelFont(WMFontPanel *panel, WMFont *font);
1249
1250 /* you can free the returned string */
1251 char *WMGetFontPanelFontName(WMFontPanel *panel);
1252
1253 WMFont *WMGetFontPanelFont(WMFontPanel *panel);
1254
1255 #ifdef __cplusplus
1256 }
1257 #endif /* __cplusplus */
1258
1259 #endif
1260