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     WC_ProgressIndicator = 15
 268 };
 269
 270 /* All widgets must start with the following structure
 271  * in that order. Used for typecasting to get some generic data */
 272 typedef struct W_WidgetType {
 273     W_Class widgetClass;
 274     struct W_View *view;
 275
 276 } W_WidgetType;
 277
 278
 279 #define WMWidgetClass(widget)   (((W_WidgetType*)(widget))->widgetClass)
 280 #define WMWidgetView(widget)    (((W_WidgetType*)(widget))->view)
 281
 282
 283 /* widgets */
 284
 285 typedef void WMWidget;
 286
 287 typedef struct W_Pixmap WMPixmap;
 288 typedef struct W_Font   WMFont;
 289 typedef struct W_Color  WMColor;
 290
 291 typedef struct W_Screen WMScreen;
 292
 293 typedef struct W_View WMView;
 294
 295 typedef struct W_Window WMWindow;
 296 typedef struct W_Frame WMFrame;
 297 typedef struct W_Button WMButton;
 298 typedef struct W_Label WMLabel;
 299 typedef struct W_TextField WMTextField;
 300 typedef struct W_Scroller WMScroller;
 301 typedef struct W_ScrollView WMScrollView;
 302 typedef struct W_List WMList;
 303 typedef struct W_Browser WMBrowser;
 304 typedef struct W_PopUpButton WMPopUpButton;
 305 typedef struct W_ProgressIndicator WMProgressIndicator;
 306 typedef struct W_ColorWell WMColorWell;
 307 typedef struct W_Slider WMSlider;
 308 typedef struct W_Matrix WMMatrix;      /* not ready */
 309 typedef struct W_SplitView WMSplitView;
 310 typedef struct W_TabView WMTabView;
 311
 312 /* not widgets */
 313 typedef struct W_TabViewItem WMTabViewItem;
 314
 315
 316 typedef struct W_FilePanel WMFilePanel;
 317 typedef WMFilePanel WMOpenPanel;
 318 typedef WMFilePanel WMSavePanel;
 319
 320 typedef struct W_FontPanel WMFontPanel;
 321
 322 typedef struct W_ColorPanel WMColorPanel;
 323
 324
 325 /* item for WMList */
 326 typedef struct WMListItem {
 327     char *text;
 328     void *clientData;                  /* ptr for user clientdata. */
 329
 330     struct WMListItem *nextPtr;
 331
 332     unsigned int uflags:16;            /* flags for the user */
 333     unsigned int selected:1;
 334     unsigned int disabled:1;
 335     unsigned int isBranch:1;
 336     unsigned int loaded:1;
 337 } WMListItem;
 338
 339 /* struct for message panel */
 340 typedef struct WMAlertPanel {
 341     WMWindow *win;                     /* window */
 342     WMButton *defBtn;                  /* default button */
 343     WMButton *altBtn;                  /* alternative button */
 344     WMButton *othBtn;                  /* other button */
 345     WMLabel *iLbl;                     /* icon label */
 346     WMLabel *tLbl;                     /* title label */
 347     WMLabel *mLbl;                     /* message label */
 348     WMFrame *line;                     /* separator */
 349     short result;                      /* button that was pushed */
 350     short done;
 351
 352     KeyCode retKey;
 353 } WMAlertPanel;
 354
 355
 356 typedef struct WMInputPanel {
 357     WMWindow *win;                     /* window */
 358     WMButton *defBtn;                  /* default button */
 359     WMButton *altBtn;                  /* alternative button */
 360     WMLabel *tLbl;                     /* title label */
 361     WMLabel *mLbl;                     /* message label */
 362     WMTextField *text;                 /* text field */
 363     short result;                      /* button that was pushed */
 364     short done;
 365
 366     KeyCode retKey;
 367 } WMInputPanel;
 368
 369
 370
 371
 372
 373
 374
 375 typedef void *WMHandlerID;
 376
 377 typedef void WMInputProc(int fd, int mask, void *clientData);
 378
 379 typedef void WMEventProc(XEvent *event, void *clientData);
 380
 381 typedef void WMEventHook(XEvent *event);
 382
 383 /* self is set to the widget from where the callback is being called and
 384  * clientData to the data set to with WMSetClientData() */
 385 typedef void WMAction(WMWidget *self, void *clientData);
 386
 387 /* same as WMAction, but for stuff that arent widgets */
 388 typedef void WMAction2(void *self, void *clientData);
 389
 390
 391 typedef void WMCallback(void *data);
 392
 393
 394 /* delegate method like stuff */
 395 typedef void WMFreeDataProc(void *data);
 396
 397 typedef void WMListDrawProc(WMList *lPtr, int index, Drawable d, char *text,
 398                             int state, WMRect *rect);
 399
 400 /*
 401 typedef void WMSplitViewResizeSubviewsProc(WMSplitView *sPtr,
 402                                            unsigned int oldWidth,
 403                                            unsigned int oldHeight);
 404 */
 405
 406 typedef void WMSplitViewConstrainProc(WMSplitView *sPtr, int dividerIndex,
 407                                       int *minCoordinate, int *maxCoordinate);
 408
 409 typedef WMWidget *WMMatrixCreateCellProc(WMMatrix *mPtr);
 410
 411
 412 typedef Bool WMConvertSelectionProc(WMWidget *w, Atom selection, Atom target,
 413                                     Atom *type, void **value, unsigned *length,
 414                                     int *format);
 415
 416 typedef void WMLoseSelectionProc(WMWidget *w, Atom selection);
 417
 418 typedef void WMSelectionDoneProc(WMWidget *w, Atom selection, Atom target);
 419
 420
 421
 422
 423 typedef struct WMBrowserDelegate {
 424     void *data;
 425
 426     void (*createRowsForColumn)(struct WMBrowserDelegate *self,
 427                                 WMBrowser *sender, int column, WMList *list);
 428
 429     char* (*titleOfColumn)(struct WMBrowserDelegate *self, WMBrowser *sender,
 430                            int column);
 431
 432     void (*didScroll)(struct WMBrowserDelegate *self, WMBrowser *sender);
 433
 434     void (*willScroll)(struct WMBrowserDelegate *self, WMBrowser *sender);
 435 } WMBrowserDelegate;
 436
 437
 438 typedef struct WMTextFieldDelegate {
 439     void *data;
 440
 441     void (*didBeginEditing)(struct WMTextFieldDelegate *self,
 442                             WMNotification *notif);
 443
 444     void (*didChange)(struct WMTextFieldDelegate *self,
 445                       WMNotification *notif);
 446
 447     void (*didEndEditing)(struct WMTextFieldDelegate *self,
 448                           WMNotification *notif);
 449
 450     Bool (*shouldBeginEditing)(struct WMTextFieldDelegate *self,
 451                                WMTextField *tPtr);
 452
 453     Bool (*shouldEndEditing)(struct WMTextFieldDelegate *self,
 454                              WMTextField *tPtr);
 455 } WMTextFieldDelegate;
 456
 457
 458
 459 typedef struct WMTabViewDelegate {
 460     void *data;
 461
 462     void (*didChangeNumberOfItems)(struct WMTabViewDelegate *self,
 463                                    WMTabView *tabView);
 464
 465     void (*didSelectItem)(struct WMTabViewDelegate *self, WMTabView *tabView,
 466                                  WMTabViewItem *item);
 467
 468     Bool (*shouldSelectItem)(struct WMTabViewDelegate *self, WMTabView *tabView,
 469                              WMTabViewItem *item);
 470
 471     void (*willSelectItem)(struct WMTabViewDelegate *self, WMTabView *tabView,
 472                            WMTabViewItem *item);
 473 } WMTabViewDelegate;
 474
 475
 476
 477 /* ....................................................................... */
 478
 479
 480
 481 void WMInitializeApplication(char *applicationName, int *argc, char **argv);
 482
 483 void WMSetResourcePath(char *path);
 484
 485 /* don't free the returned string */
 486 char *WMGetApplicationName();
 487
 488 /* Try to locate resource file. ext may be NULL */
 489 char *WMPathForResourceOfType(char *resource, char *ext);
 490
 491 WMScreen *WMCreateScreenWithRContext(Display *display, int screen,
 492                                      RContext *context);
 493
 494 WMScreen *WMCreateScreen(Display *display, int screen);
 495
 496 WMScreen *WMCreateSimpleApplicationScreen(Display *display);
 497
 498 void WMScreenMainLoop(WMScreen *scr);
 499
 500
 501 RContext *WMScreenRContext(WMScreen *scr);
 502
 503 Display *WMScreenDisplay(WMScreen *scr);
 504
 505 int WMScreenDepth(WMScreen *scr);
 506
 507
 508
 509 void WMSetApplicationIconImage(WMScreen *app, WMPixmap *icon);
 510
 511 WMPixmap *WMGetApplicationIconImage(WMScreen *app);
 512
 513 void WMSetFocusToWidget(WMWidget *widget);
 514
 515 WMEventHook *WMHookEventHandler(WMEventHook *handler);
 516
 517 int WMHandleEvent(XEvent *event);
 518
 519 Bool WMScreenPending(WMScreen *scr);
 520
 521 void WMCreateEventHandler(WMView *view, unsigned long mask,
 522                           WMEventProc *eventProc, void *clientData);
 523
 524 void WMDeleteEventHandler(WMView *view, unsigned long mask,
 525                           WMEventProc *eventProc, void *clientData);
 526
 527 int WMIsDoubleClick(XEvent *event);
 528
 529 void WMNextEvent(Display *dpy, XEvent *event);
 530
 531 void WMMaskEvent(Display *dpy, long mask, XEvent *event);
 532
 533 WMHandlerID WMAddTimerHandler(int milliseconds, WMCallback *callback,
 534                               void *cdata);
 535
 536 void WMDeleteTimerWithClientData(void *cdata);
 537
 538 void WMDeleteTimerHandler(WMHandlerID handlerID);
 539
 540 WMHandlerID WMAddIdleHandler(WMCallback *callback, void *cdata);
 541
 542 void WMDeleteIdleHandler(WMHandlerID handlerID);
 543
 544 WMHandlerID WMAddInputHandler(int fd, int condition, WMInputProc *proc,
 545                               void *clientData);
 546
 547 void WMDeleteInputHandler(WMHandlerID handlerID);
 548
 549 Bool WMCreateSelectionHandler(WMWidget *w, Atom selection, Time timestamp,
 550                               WMConvertSelectionProc *convProc,
 551                               WMLoseSelectionProc *loseProc,
 552                               WMSelectionDoneProc *doneProc);
 553
 554 void WMDeleteSelectionHandler(WMWidget *widget, Atom selection);
 555
 556
 557 /* ....................................................................... */
 558 /*
 559 void WMDragImageFromView(WMView *view, WMPixmap *image, WMPoint atLocation,
 560                          WMSize mouseOffset, XEvent *event, Bool slideBack);
 561
 562 */
 563
 564 /* ....................................................................... */
 565
 566 WMFont *WMCreateFontSet(WMScreen *scrPtr, char *fontName);
 567
 568 WMFont *WMCreateNormalFont(WMScreen *scrPtr, char *fontName);
 569
 570 WMFont *WMCreateFont(WMScreen *scrPtr, char *fontName);
 571
 572 WMFont *WMRetainFont(WMFont *font);
 573
 574 void WMReleaseFont(WMFont *font);
 575
 576 unsigned int WMFontHeight(WMFont *font);
 577
 578 /*
 579 WMFont *WMUserFontOfSize(WMScreen *scrPtr, int size);
 580
 581 WMFont *WMUserFixedPitchFontOfSize(WMScreen *scrPtr, int size);
 582 */
 583
 584 WMFont *WMSystemFontOfSize(WMScreen *scrPtr, int size);
 585
 586 WMFont *WMBoldSystemFontOfSize(WMScreen *scrPtr, int size);
 587
 588 XFontSet WMGetFontFontSet(WMFont *font);
 589
 590 /* ....................................................................... */
 591
 592 WMPixmap *WMRetainPixmap(WMPixmap *pixmap);
 593
 594 void WMReleasePixmap(WMPixmap *pixmap);
 595
 596 WMPixmap *WMCreatePixmap(WMScreen *scrPtr, int width, int height, int depth,
 597                          Bool masked);
 598
 599 WMPixmap *WMCreatePixmapFromXPixmaps(WMScreen *scrPtr, Pixmap pixmap,
 600                                      Pixmap mask, int width, int height,
 601                                      int depth);
 602
 603 WMPixmap *WMCreatePixmapFromRImage(WMScreen *scrPtr, RImage *image,
 604                                    int threshold);
 605
 606 WMPixmap *WMCreatePixmapFromXPMData(WMScreen *scrPtr, char **data);
 607
 608 WMSize WMGetPixmapSize(WMPixmap *pixmap);
 609
 610 WMPixmap *WMCreatePixmapFromFile(WMScreen *scrPtr, char *fileName);
 611
 612 WMPixmap *WMCreateBlendedPixmapFromFile(WMScreen *scrPtr, char *fileName,
 613                                         RColor *color);
 614
 615 void WMDrawPixmap(WMPixmap *pixmap, Drawable d, int x, int y);
 616
 617 Pixmap WMGetPixmapXID(WMPixmap *pixmap);
 618
 619 Pixmap WMGetPixmapMaskXID(WMPixmap *pixmap);
 620
 621 WMPixmap *WMGetSystemPixmap(WMScreen *scr, int image);
 622
 623 /* ....................................................................... */
 624
 625
 626 WMColor *WMDarkGrayColor(WMScreen *scr);
 627
 628 WMColor *WMGrayColor(WMScreen *scr);
 629
 630 WMColor *WMBlackColor(WMScreen *scr);
 631
 632 WMColor *WMWhiteColor(WMScreen *scr);
 633
 634 void WMSetColorInGC(WMColor *color, GC gc);
 635
 636 GC WMColorGC(WMColor *color);
 637
 638 WMPixel WMColorPixel(WMColor *color);
 639
 640 void WMPaintColorSwatch(WMColor *color, Drawable d, int x, int y,
 641                         unsigned int width, unsigned int height);
 642
 643 void WMReleaseColor(WMColor *color);
 644
 645 WMColor *WMRetainColor(WMColor *color);
 646
 647 WMColor *WMCreateRGBColor(WMScreen *scr, unsigned short red,
 648                           unsigned short green, unsigned short blue,
 649                           Bool exact);
 650
 651 WMColor *WMCreateNamedColor(WMScreen *scr, char *name, Bool exact);
 652
 653 unsigned short WMRedComponentOfColor(WMColor *color);
 654
 655 unsigned short WMGreenComponentOfColor(WMColor *color);
 656
 657 unsigned short WMBlueComponentOfColor(WMColor *color);
 658
 659 char *WMGetColorRGBDescription(WMColor *color);
 660
 661 /* ....................................................................... */
 662
 663
 664 void WMDrawString(WMScreen *scr, Drawable d, GC gc, WMFont *font, int x,
 665                   int y, char *text, int length);
 666
 667 void WMDrawImageString(WMScreen *scr, Drawable d, GC gc, WMFont *font, int x,
 668                        int y, char *text, int length);
 669
 670 int WMWidthOfString(WMFont *font, char *text, int length);
 671
 672
 673
 674 /* ....................................................................... */
 675
 676 WMScreen *WMWidgetScreen(WMWidget *w);
 677
 678 unsigned int WMScreenWidth(WMScreen *scr);
 679
 680 unsigned int WMScreenHeight(WMScreen *scr);
 681
 682 void WMUnmapWidget(WMWidget *w);
 683
 684 void WMMapWidget(WMWidget *w);
 685
 686 void WMMoveWidget(WMWidget *w, int x, int y);
 687
 688 void WMResizeWidget(WMWidget *w, unsigned int width, unsigned int height);
 689
 690 void WMSetWidgetBackgroundColor(WMWidget *w, WMColor *color);
 691
 692 void WMMapSubwidgets(WMWidget *w);
 693
 694 void WMUnmapSubwidgets(WMWidget *w);
 695
 696 void WMRealizeWidget(WMWidget *w);
 697
 698 void WMDestroyWidget(WMWidget *widget);
 699
 700 void WMHangData(WMWidget *widget, void *data);
 701
 702 void *WMGetHangedData(WMWidget *widget);
 703
 704 unsigned int WMWidgetWidth(WMWidget *w);
 705
 706 unsigned int WMWidgetHeight(WMWidget *w);
 707
 708 Window WMWidgetXID(WMWidget *w);
 709
 710 Window WMViewXID(WMView *view);
 711
 712 void WMRedisplayWidget(WMWidget *w);
 713
 714 void WMSetViewNotifySizeChanges(WMView *view, Bool flag);
 715
 716 WMSize WMGetViewSize(WMView *view);
 717
 718 WMPoint WMGetViewPosition(WMView *view);
 719
 720 WMWidget *WMWidgetOfView(WMView *view);
 721
 722 /* notifications */
 723 extern char *WMViewSizeDidChangeNotification;
 724
 725 extern char *WMViewRealizedNotification;
 726
 727
 728 /* ....................................................................... */
 729
 730 void WMSetBalloonTextForView(char *text, WMView *view);
 731
 732 void WMSetBalloonTextAlignment(WMScreen *scr, WMAlignment alignment);
 733
 734 void WMSetBalloonFont(WMScreen *scr, WMFont *font);
 735
 736 void WMSetBalloonTextColor(WMScreen *scr, WMColor *color);
 737
 738 void WMSetBalloonDelay(WMScreen *scr, int delay);
 739
 740 void WMSetBalloonEnabled(WMScreen *scr, Bool flag);
 741
 742
 743 /* ....................................................................... */
 744
 745 WMWindow *WMCreateWindow(WMScreen *screen, char *name);
 746
 747 WMWindow *WMCreateWindowWithStyle(WMScreen *screen, char *name, int style);
 748
 749 WMWindow *WMCreatePanelWithStyleForWindow(WMWindow *owner, char *name,
 750                                           int style);
 751
 752 WMWindow *WMCreatePanelForWindow(WMWindow *owner, char *name);
 753
 754 void WMChangePanelOwner(WMWindow *win, WMWindow *newOwner);
 755
 756 void WMSetWindowTitle(WMWindow *wPtr, char *title);
 757
 758 void WMSetWindowMiniwindowTitle(WMWindow *win, char *title);
 759
 760 void WMSetWindowMiniwindowImage(WMWindow *win, WMPixmap *pixmap);
 761
 762 void WMSetWindowCloseAction(WMWindow *win, WMAction *action, void *clientData);
 763
 764 void WMSetWindowUPosition(WMWindow *win, int x, int y);
 765
 766 void WMSetWindowUSize(WMWindow *win, unsigned width, unsigned height);
 767
 768 void WMSetWindowMaxSize(WMWindow *win, unsigned width, unsigned height);
 769
 770 void WMSetWindowMinSize(WMWindow *win, unsigned width, unsigned height);
 771
 772 void WMSetWindowBaseSize(WMWindow *win, unsigned width, unsigned height);
 773
 774 void WMSetWindowResizeIncrements(WMWindow *win, unsigned wIncr, unsigned hIncr);
 775
 776 void WMSetWindowLevel(WMWindow *win, int level);
 777
 778 void WMSetWindowDocumentEdited(WMWindow *win, Bool flag);
 779
 780 void WMCloseWindow(WMWindow *win);
 781
 782 /* ....................................................................... */
 783
 784 void WMSetButtonAction(WMButton *bPtr, WMAction *action, void *clientData);
 785
 786 #define WMCreateCommandButton(parent) \
 787         WMCreateCustomButton((parent), WBBSpringLoadedMask\
 788                                         |WBBPushInMask\
 789                                         |WBBPushLightMask\
 790                                         |WBBPushChangeMask)
 791
 792 #define WMCreateRadioButton(parent) \
 793         WMCreateButton((parent), WBTRadio)
 794
 795 #define WMCreateSwitchButton(parent) \
 796         WMCreateButton((parent), WBTSwitch)
 797
 798 WMButton *WMCreateButton(WMWidget *parent, WMButtonType type);
 799
 800 WMButton *WMCreateCustomButton(WMWidget *parent, int behaviourMask);
 801
 802 void WMSetButtonImageDefault(WMButton *bPtr);
 803
 804 void WMSetButtonImage(WMButton *bPtr, WMPixmap *image);
 805
 806 void WMSetButtonAltImage(WMButton *bPtr, WMPixmap *image);
 807
 808 void WMSetButtonImagePosition(WMButton *bPtr, WMImagePosition position);
 809
 810 void WMSetButtonFont(WMButton *bPtr, WMFont *font);
 811
 812 void WMSetButtonTextAlignment(WMButton *bPtr, WMAlignment alignment);
 813
 814 void WMSetButtonText(WMButton *bPtr, char *text);
 815
 816 void WMSetButtonAltText(WMButton *bPtr, char *text);
 817
 818 void WMSetButtonSelected(WMButton *bPtr, int isSelected);
 819
 820 int WMGetButtonSelected(WMButton *bPtr);
 821
 822 void WMSetButtonBordered(WMButton *bPtr, int isBordered);
 823
 824 void WMSetButtonEnabled(WMButton *bPtr, Bool flag);
 825
 826 void WMSetButtonImageDimsWhenDisabled(WMButton *bPtr, Bool flag);
 827
 828 void WMSetButtonTag(WMButton *bPtr, int tag);
 829
 830 void WMGroupButtons(WMButton *bPtr, WMButton *newMember);
 831
 832 void WMPerformButtonClick(WMButton *bPtr);
 833
 834 void WMSetButtonContinuous(WMButton *bPtr, Bool flag);
 835
 836 void WMSetButtonPeriodicDelay(WMButton *bPtr, float delay, float interval);
 837
 838 /* ....................................................................... */
 839
 840 WMLabel *WMCreateLabel(WMWidget *parent);
 841
 842 void WMSetLabelWraps(WMLabel *lPtr, Bool flag);
 843
 844 void WMSetLabelImage(WMLabel *lPtr, WMPixmap *image);
 845
 846 WMPixmap *WMGetLabelImage(WMLabel *lPtr);
 847
 848 void WMSetLabelImagePosition(WMLabel *lPtr, WMImagePosition position);
 849
 850 void WMSetLabelTextAlignment(WMLabel *lPtr, WMAlignment alignment);
 851
 852 void WMSetLabelRelief(WMLabel *lPtr, WMReliefType relief);
 853
 854 void WMSetLabelText(WMLabel *lPtr, char *text);
 855
 856 void WMSetLabelFont(WMLabel *lPtr, WMFont *font);
 857
 858 void WMSetLabelTextColor(WMLabel *lPtr, WMColor *color);
 859
 860 /* ....................................................................... */
 861
 862 WMFrame *WMCreateFrame(WMWidget *parent);
 863
 864 void WMSetFrameTitlePosition(WMFrame *fPtr, WMTitlePosition position);
 865
 866 void WMSetFrameRelief(WMFrame *fPtr, WMReliefType relief);
 867
 868 void WMSetFrameTitle(WMFrame *fPtr, char *title);
 869
 870 /* ....................................................................... */
 871
 872 WMTextField *WMCreateTextField(WMWidget *parent);
 873
 874 void WMInsertTextFieldText(WMTextField *tPtr, char *text, int position);
 875
 876 void WMDeleteTextFieldRange(WMTextField *tPtr, WMRange range);
 877
 878 /* you can free the returned string */
 879 char *WMGetTextFieldText(WMTextField *tPtr);
 880
 881 void WMSetTextFieldText(WMTextField *tPtr, char *text);
 882
 883 void WMSetTextFieldAlignment(WMTextField *tPtr, WMAlignment alignment);
 884
 885 void WMSetTextFieldBordered(WMTextField *tPtr, Bool bordered);
 886
 887 void WMSetTextFieldBeveled(WMTextField *tPtr, Bool flag);
 888
 889 Bool WMGetTextFieldEditable(WMTextField *tPtr);
 890
 891 void WMSetTextFieldEditable(WMTextField *tPtr, Bool flag);
 892
 893 void WMSetTextFieldSecure(WMTextField *tPtr, Bool flag);
 894
 895 void WMSelectTextFieldRange(WMTextField *tPtr, WMRange range);
 896
 897 void WMSetTextFieldCursorPosition(WMTextField *tPtr, unsigned int position);
 898
 899 void WMSetTextFieldNextTextField(WMTextField *tPtr, WMTextField *next);
 900
 901 void WMSetTextFieldPrevTextField(WMTextField *tPtr, WMTextField *prev);
 902
 903 void WMSetTextFieldDelegate(WMTextField *tPtr, WMTextFieldDelegate *delegate);
 904
 905
 906 extern char *WMTextDidChangeNotification;
 907 extern char *WMTextDidBeginEditingNotification;
 908 extern char *WMTextDidEndEditingNotification;
 909
 910 /* ....................................................................... */
 911
 912 WMScroller *WMCreateScroller(WMWidget *parent);
 913
 914 void WMSetScrollerParameters(WMScroller *sPtr, float floatValue,
 915                              float knobProportion);
 916
 917 float WMGetScrollerKnobProportion(WMScroller *sPtr);
 918
 919 float WMGetScrollerValue(WMScroller *sPtr);
 920
 921 WMScrollerPart WMGetScrollerHitPart(WMScroller *sPtr);
 922
 923 void WMSetScrollerAction(WMScroller *sPtr, WMAction *action, void *clientData);
 924
 925 void WMSetScrollerArrowsPosition(WMScroller *sPtr,
 926                                  WMScrollArrowPosition position);
 927
 928 /* ....................................................................... */
 929
 930 WMList *WMCreateList(WMWidget *parent);
 931
 932 #define WMAddListItem(lPtr, text) WMInsertListItem((lPtr), -1, (text))
 933
 934 WMListItem *WMInsertListItem(WMList *lPtr, int row, char *text);
 935
 936 WMListItem *WMAddSortedListItem(WMList *lPtr, char *text);
 937
 938 int WMFindRowOfListItemWithTitle(WMList *lPtr, char *title);
 939
 940 WMListItem *WMGetListItem(WMList *lPtr, int row);
 941
 942 void WMRemoveListItem(WMList *lPtr, int row);
 943
 944 void WMSelectListItem(WMList *lPtr, int row);
 945
 946 void WMSetListUserDrawProc(WMList *lPtr, WMListDrawProc *proc);
 947
 948 void WMSetListUserDrawItemHeight(WMList *lPtr, unsigned short height);
 949
 950 int WMGetListItemHeight(WMList *lPtr);
 951
 952 /* don't free the returned data */
 953 WMListItem *WMGetListSelectedItem(WMList *lPtr);
 954
 955 int WMGetListSelectedItemRow(WMList *lPtr);
 956
 957 void WMSetListAction(WMList *lPtr, WMAction *action, void *clientData);
 958
 959 void WMSetListDoubleAction(WMList *lPtr, WMAction *action, void *clientData);
 960
 961 void WMClearList(WMList *lPtr);
 962
 963 int WMGetListNumberOfRows(WMList *lPtr);
 964
 965 void WMSetListPosition(WMList *lPtr, int row);
 966
 967 void WMSetListBottomPosition(WMList *lPtr, int row);
 968
 969 int WMGetListPosition(WMList *lPtr);
 970
 971 extern char *WMListDidScrollNotification;
 972 extern char *WMListSelectionDidChangeNotification;
 973
 974 /* ....................................................................... */
 975
 976 WMBrowser *WMCreateBrowser(WMWidget *parent);
 977
 978 void WMSetBrowserPathSeparator(WMBrowser *bPtr, char *separator);
 979
 980 void WMSetBrowserTitled(WMBrowser *bPtr, Bool flag);
 981
 982 void WMLoadBrowserColumnZero(WMBrowser *bPtr);
 983
 984 int WMAddBrowserColumn(WMBrowser *bPtr);
 985
 986 void WMRemoveBrowserItem(WMBrowser *bPtr, int column, int row);
 987
 988 void WMSetBrowserMaxVisibleColumns(WMBrowser *bPtr, int columns);
 989
 990 void WMSetBrowserColumnTitle(WMBrowser *bPtr, int column, char *title);
 991
 992 WMListItem *WMAddSortedBrowserItem(WMBrowser *bPtr, int column, char *text, Bool isBranch);
 993
 994 WMListItem *WMInsertBrowserItem(WMBrowser *bPtr, int column, int row, char *text, Bool isBranch);
 995
 996 /* Don't free the returned string. */
 997 char* WMSetBrowserPath(WMBrowser *bPtr, char *path);
 998
 999 /* you can free the returned string */
1000 char *WMGetBrowserPath(WMBrowser *bPtr);
1001 /* you can free the returned string */
1002 char *WMGetBrowserPathToColumn(WMBrowser *bPtr, int column);
1003
1004 void WMSetBrowserAction(WMBrowser *bPtr, WMAction *action, void *clientData);
1005
1006 void WMSetBrowserDoubleAction(WMBrowser *bPtr, WMAction *action,
1007                               void *clientData);
1008
1009 WMListItem *WMGetBrowserSelectedItemInColumn(WMBrowser *bPtr, int column);
1010
1011 int WMGetBrowserFirstVisibleColumn(WMBrowser *bPtr);
1012
1013 int WMGetBrowserSelectedColumn(WMBrowser *bPtr);
1014
1015 int WMGetBrowserSelectedRowInColumn(WMBrowser *bPtr, int column);
1016
1017 int WMGetBrowserNumberOfColumns(WMBrowser *bPtr);
1018
1019 int WMGetBrowserMaxVisibleColumns(WMBrowser *bPtr);
1020
1021 WMList *WMGetBrowserListInColumn(WMBrowser *bPtr, int column);
1022
1023 void WMSetBrowserDelegate(WMBrowser *bPtr, WMBrowserDelegate *delegate);
1024
1025 /* ....................................................................... */
1026
1027 WMPopUpButton *WMCreatePopUpButton(WMWidget *parent);
1028
1029 void WMSetPopUpButtonAction(WMPopUpButton *sPtr, WMAction *action,
1030                             void *clientData);
1031
1032 void WMSetPopUpButtonPullsDown(WMPopUpButton *bPtr, Bool flag);
1033
1034 void WMAddPopUpButtonItem(WMPopUpButton *bPtr, char *title);
1035
1036 void WMInsertPopUpButtonItem(WMPopUpButton *bPtr, int index, char *title);
1037
1038 void WMRemovePopUpButtonItem(WMPopUpButton *bPtr, int index);
1039
1040 void WMSetPopUpButtonItemEnabled(WMPopUpButton *bPtr, int index, Bool flag);
1041
1042 Bool WMGetPopUpButtonItemEnabled(WMPopUpButton *bPtr, int index);
1043
1044 void WMSetPopUpButtonSelectedItem(WMPopUpButton *bPtr, int index);
1045
1046 int WMGetPopUpButtonSelectedItem(WMPopUpButton *bPtr);
1047
1048 void WMSetPopUpButtonText(WMPopUpButton *bPtr, char *text);
1049
1050 /* don't free the returned data */
1051 char *WMGetPopUpButtonItem(WMPopUpButton *bPtr, int index);
1052
1053 int WMGetPopUpButtonNumberOfItems(WMPopUpButton *bPtr);
1054
1055 void WMSetPopUpButtonEnabled(WMPopUpButton *bPtr, Bool flag);
1056
1057 Bool WMGetPopUpButtonEnabled(WMPopUpButton *bPtr);
1058
1059 /* ....................................................................... */
1060
1061 WMProgressIndicator *WMCreateProgressIndicator(WMWidget *parent);
1062
1063 void WMSetProgressIndicatorMinValue(WMProgressIndicator *progressindicator, int value);
1064
1065 void WMSetProgressIndicatorMaxValue(WMProgressIndicator *progressindicator, int value);
1066
1067 void WMSetProgressIndicatorValue(WMProgressIndicator *progressindicator, int value);
1068
1069 int WMGetProgressIndicatorMinValue(WMProgressIndicator *progressindicator);
1070
1071 int WMGetProgressIndicatorMaxValue(WMProgressIndicator *progressindicator);
1072
1073 int WMGetProgressIndicatorValue(WMProgressIndicator *progressindicator);
1074
1075
1076 /* ....................................................................... */
1077
1078 WMColorPanel *WMGetColorPanel(WMScreen *scrPtr);
1079
1080 void WMFreeColorPanel(WMColorPanel *panel);
1081
1082 void WMShowColorPanel(WMColorPanel *panel);
1083
1084 void WMCloseColorPanel(WMColorPanel *panel);
1085
1086 void WMSetColorPanelColor(WMColorPanel *panel, WMColor *color);
1087
1088 WMColor *WMGetColorPanelColor(WMColorPanel *panel);
1089
1090 void WMSetColorPanelPickerMode(WMColorPanel *panel, WMColorPanelMode mode);
1091
1092 void WMSetColorPanelAction(WMColorPanel *panel, WMAction2 *action, void *data);
1093
1094 extern char *WMColorPanelColorChangedNotification;
1095
1096 /* ....................................................................... */
1097
1098 WMColorWell *WMCreateColorWell(WMWidget *parent);
1099
1100 void WMSetColorWellColor(WMColorWell *cPtr, WMColor *color);
1101
1102 WMColor *WMGetColorWellColor(WMColorWell *cPtr);
1103
1104 void WSetColorWellBordered(WMColorWell *cPtr, Bool flag);
1105
1106
1107 extern char *WMColorWellDidChangeNotification;
1108
1109
1110 /* ...................................................................... */
1111
1112 WMScrollView *WMCreateScrollView(WMWidget *parent);
1113
1114 void WMResizeScrollViewContent(WMScrollView *sPtr, unsigned int width,
1115                                unsigned int height);
1116
1117 void WMSetScrollViewHasHorizontalScroller(WMScrollView *sPtr, Bool flag);
1118
1119 void WMSetScrollViewHasVerticalScroller(WMScrollView *sPtr, Bool flag);
1120
1121 void WMSetScrollViewContentView(WMScrollView *sPtr, WMView *view);
1122
1123 void WMSetScrollViewRelief(WMScrollView *sPtr, WMReliefType type);
1124
1125 void WMSetScrollViewContentView(WMScrollView *sPtr, WMView *view);
1126
1127 WMScroller *WMGetScrollViewHorizontalScroller(WMScrollView *sPtr);
1128
1129 WMScroller *WMGetScrollViewVerticalScroller(WMScrollView *sPtr);
1130
1131 void WMSetScrollViewLineScroll(WMScrollView *sPtr, int amount);
1132
1133 void WMSetScrollViewPageScroll(WMScrollView *sPtr, int amount);
1134
1135 /* ....................................................................... */
1136
1137 WMSlider *WMCreateSlider(WMWidget *parent);
1138
1139 int WMGetSliderMinValue(WMSlider *slider);
1140
1141 int WMGetSliderMaxValue(WMSlider *slider);
1142
1143 int WMGetSliderValue(WMSlider *slider);
1144
1145 void WMSetSliderMinValue(WMSlider *slider, int value);
1146
1147 void WMSetSliderMaxValue(WMSlider *slider, int value);
1148
1149 void WMSetSliderValue(WMSlider *slider, int value);
1150
1151 void WMSetSliderContinuous(WMSlider *slider, Bool flag);
1152
1153 void WMSetSliderAction(WMSlider *slider, WMAction *action, void *data);
1154
1155 void WMSetSliderKnobThickness(WMSlider *sPtr, int thickness);
1156
1157 void WMSetSliderImage(WMSlider *sPtr, WMPixmap *pixmap);
1158
1159 /* ....................................................................... */
1160
1161 /* only supports 2 subviews */
1162 WMSplitView *WMCreateSplitView(WMWidget *parent);
1163
1164 void WMAddSplitViewSubview(WMSplitView *sPtr, WMView *subview);
1165
1166 void WMAdjustSplitViewSubviews(WMSplitView *sPtr);
1167
1168 void WMSetSplitViewConstrainProc(WMSplitView *sPtr,
1169                                  WMSplitViewConstrainProc *proc);
1170
1171 /*
1172 void WMSetSplitViewResizeSubviewsProc(WMSplitView *sPtr,
1173                                       WMSplitViewResizeSubviewsProc *proc);
1174 */
1175
1176 int WMGetSplitViewDividerThickness(WMSplitView *sPtr);
1177
1178
1179 /* ....................................................................... */
1180
1181
1182 WMTabView *WMCreateTabView(WMWidget *parent);
1183
1184 void WMSetTabViewFont(WMTabView *tPtr, WMFont *font);
1185
1186 void WMAddItemInTabView(WMTabView *tPtr, WMTabViewItem *item);
1187
1188 void WMInsertItemInTabView(WMTabView *tPtr, int index, WMTabViewItem *item);
1189
1190 void WMRemoveTabViewItem(WMTabView *tPtr, WMTabViewItem *item);
1191
1192 WMTabViewItem *WMTabViewItemAtPoint(WMTabView *tPtr, int x, int y);
1193
1194 void WMSelectFirstTabViewItem(WMTabView *tPtr);
1195
1196 void WMSelectLastTabViewItem(WMTabView *tPtr);
1197
1198 void WMSelectNextTabViewItem(WMTabView *tPtr);
1199
1200 void WMSelectPreviousTabViewItem(WMTabView *tPtr);
1201
1202 WMTabViewItem *WMGetSelectedTabViewItem(WMTabView *tPtr);
1203
1204 void WMSelectTabViewItem(WMTabView *tPtr, WMTabViewItem *item);
1205
1206 void WMSelectTabViewItemAtIndex(WMTabView *tPtr, int index);
1207
1208 void WMSetTabViewDelegate(WMTabView *tPtr, WMTabViewDelegate *delegate);
1209
1210
1211 WMTabViewItem *WMCreateTabViewItemWithIdentifier(int identifier);
1212
1213 int WMGetTabViewItemIdentifier(WMTabViewItem *item);
1214
1215 void WMSetTabViewItemLabel(WMTabViewItem *item, char *label);
1216
1217 char *WMGetTabViewItemLabel(WMTabViewItem *item);
1218
1219 void WMSetTabViewItemView(WMTabViewItem *item, WMView *view);
1220
1221 WMView *WMGetTabViewItemView(WMTabViewItem *item);
1222
1223 void WMDestroyTabViewItem(WMTabViewItem *item);
1224
1225 /* ....................................................................... */
1226
1227 int WMRunAlertPanel(WMScreen *app, WMWindow *owner, char *title, char *msg,
1228                     char *defaultButton, char *alternateButton,
1229                     char *otherButton);
1230
1231 /* you can free the returned string */
1232 char *WMRunInputPanel(WMScreen *app, WMWindow *owner, char *title, char *msg,
1233                       char *defaultText, char *okButton, char *cancelButton);
1234
1235 WMAlertPanel *WMCreateAlertPanel(WMScreen *app, WMWindow *owner, char *title,
1236                                  char *msg, char *defaultButton,
1237                                  char *alternateButton, char *otherButton);
1238
1239 WMInputPanel *WMCreateInputPanel(WMScreen *app, WMWindow *owner, char *title,
1240                                  char *msg, char *defaultText, char *okButton,
1241                                  char *cancelButton);
1242
1243 void WMDestroyAlertPanel(WMAlertPanel *panel);
1244
1245 void WMDestroyInputPanel(WMInputPanel *panel);
1246
1247 /* ....................................................................... */
1248
1249 /* only 1 instance per WMScreen */
1250 WMOpenPanel *WMGetOpenPanel(WMScreen *scrPtr);
1251
1252 WMSavePanel *WMGetSavePanel(WMScreen *scrPtr);
1253
1254 void WMSetFilePanelCanChooseDirectories(WMFilePanel *panel, Bool flag);
1255
1256 void WMSetFilePanelCanChooseFiles(WMFilePanel *panel, Bool flag);
1257
1258 void WMSetFilePanelAutoCompletion(WMFilePanel *panel, Bool flag);
1259
1260 void WMSetFilePanelDirectory(WMFilePanel *panel, char *path);
1261
1262 /* you can free the returned string */
1263 char *WMGetFilePanelFileName(WMFilePanel *panel);
1264
1265 void WMFreeFilePanel(WMFilePanel *panel);
1266
1267 int WMRunModalFilePanelForDirectory(WMFilePanel *panel, WMWindow *owner,
1268                                     char *path, char *name, char **fileTypes);
1269
1270 void WMSetFilePanelAccessoryView(WMFilePanel *panel, WMView *view);
1271
1272 WMView *WMGetFilePanelAccessoryView(WMFilePanel *panel);
1273
1274
1275 /* ...................................................................... */
1276
1277 /* only 1 instance per WMScreen */
1278 WMFontPanel *WMGetFontPanel(WMScreen *scr);
1279
1280 void WMShowFontPanel(WMFontPanel *panel);
1281
1282 void WMHideFontPanel(WMFontPanel *panel);
1283
1284 void WMSetFontPanelFont(WMFontPanel *panel, WMFont *font);
1285
1286 /* you can free the returned string */
1287 char *WMGetFontPanelFontName(WMFontPanel *panel);
1288
1289 WMFont *WMGetFontPanelFont(WMFontPanel *panel);
1290
1291 #ifdef __cplusplus
1292 }
1293 #endif /* __cplusplus */
1294
1295 #endif
1296