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