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 /* ....................................................................... */
 457
 458
 459
 460 void WMInitializeApplication(char *applicationName, int *argc, char **argv);
 461
 462 void WMSetApplicationDataPath(char *path);
 463
 464 /* don't free the returned string */
 465 char *WMGetApplicationName();
 466
 467 /* Try to locate resource file. ext may be NULL */
 468 char *WMPathForResourceOfType(char *resource, char *ext);
 469
 470 WMScreen *WMCreateScreenWithRContext(Display *display, int screen,
 471                                      RContext *context);
 472
 473 WMScreen *WMCreateScreen(Display *display, int screen);
 474
 475 WMScreen *WMCreateSimpleApplicationScreen(Display *display);
 476
 477 void WMScreenMainLoop(WMScreen *scr);
 478
 479
 480 RContext *WMScreenRContext(WMScreen *scr);
 481
 482 Display *WMScreenDisplay(WMScreen *scr);
 483
 484 int WMScreenDepth(WMScreen *scr);
 485
 486
 487
 488 void WMSetApplicationIconImage(WMScreen *app, WMPixmap *icon);
 489
 490 WMPixmap *WMGetApplicationIconImage(WMScreen *app);
 491
 492 void WMSetFocusToWidget(WMWidget *widget);
 493
 494 WMEventHook *WMHookEventHandler(WMEventHook *handler);
 495
 496 int WMHandleEvent(XEvent *event);
 497
 498 Bool WMScreenPending(WMScreen *scr);
 499
 500 void WMCreateEventHandler(WMView *view, unsigned long mask,
 501                           WMEventProc *eventProc, void *clientData);
 502
 503 void WMDeleteEventHandler(WMView *view, unsigned long mask,
 504                           WMEventProc *eventProc, void *clientData);
 505
 506 int WMIsDoubleClick(XEvent *event);
 507
 508 void WMNextEvent(Display *dpy, XEvent *event);
 509
 510 void WMMaskEvent(Display *dpy, long mask, XEvent *event);
 511
 512 WMHandlerID WMAddTimerHandler(int milliseconds, WMCallback *callback,
 513                               void *cdata);
 514
 515 void WMDeleteTimerWithClientData(void *cdata);
 516
 517 void WMDeleteTimerHandler(WMHandlerID handlerID);
 518
 519 WMHandlerID WMAddIdleHandler(WMCallback *callback, void *cdata);
 520
 521 void WMDeleteIdleHandler(WMHandlerID handlerID);
 522
 523 WMHandlerID WMAddInputHandler(int fd, int condition, WMInputProc *proc,
 524                               void *clientData);
 525
 526 void WMDeleteInputHandler(WMHandlerID handlerID);
 527
 528 /* ....................................................................... */
 529 /*
 530 void WMDragImageFromView(WMView *view, WMPixmap *image, WMPoint atLocation,
 531                          WMSize mouseOffset, XEvent *event, Bool slideBack);
 532
 533 */
 534
 535 /* ....................................................................... */
 536
 537 WMFont *WMCreateFont(WMScreen *scrPtr, char *fontName);
 538
 539 WMFont *WMCreateFontInDefaultEncoding(WMScreen *scrPtr, char *fontName);
 540
 541 WMFont *WMRetainFont(WMFont *font);
 542
 543 void WMReleaseFont(WMFont *font);
 544
 545 unsigned int WMFontHeight(WMFont *font);
 546
 547 /*
 548 WMFont *WMUserFontOfSize(WMScreen *scrPtr, int size);
 549
 550 WMFont *WMUserFixedPitchFontOfSize(WMScreen *scrPtr, int size);
 551 */
 552
 553 WMFont *WMSystemFontOfSize(WMScreen *scrPtr, int size);
 554
 555 WMFont *WMBoldSystemFontOfSize(WMScreen *scrPtr, int size);
 556
 557 XFontSet WMGetFontFontSet(WMFont *font);
 558
 559 /* ....................................................................... */
 560
 561 WMPixmap *WMRetainPixmap(WMPixmap *pixmap);
 562
 563 void WMReleasePixmap(WMPixmap *pixmap);
 564
 565 WMPixmap *WMCreatePixmap(WMScreen *scrPtr, int width, int height, int depth,
 566                          Bool masked);
 567
 568 WMPixmap *WMCreatePixmapFromXPixmaps(WMScreen *scrPtr, Pixmap pixmap,
 569                                      Pixmap mask, int width, int height,
 570                                      int depth);
 571
 572 WMPixmap *WMCreatePixmapFromRImage(WMScreen *scrPtr, RImage *image,
 573                                    int threshold);
 574
 575 WMPixmap *WMCreatePixmapFromXPMData(WMScreen *scrPtr, char **data);
 576
 577 WMSize WMGetPixmapSize(WMPixmap *pixmap);
 578
 579 WMPixmap *WMCreatePixmapFromFile(WMScreen *scrPtr, char *fileName);
 580
 581 WMPixmap *WMCreateBlendedPixmapFromFile(WMScreen *scrPtr, char *fileName,
 582                                         RColor *color);
 583
 584 void WMDrawPixmap(WMPixmap *pixmap, Drawable d, int x, int y);
 585
 586 Pixmap WMGetPixmapXID(WMPixmap *pixmap);
 587
 588 Pixmap WMGetPixmapMaskXID(WMPixmap *pixmap);
 589
 590 WMPixmap *WMGetSystemPixmap(WMScreen *scr, int image);
 591
 592 /* ....................................................................... */
 593
 594
 595 WMColor *WMDarkGrayColor(WMScreen *scr);
 596
 597 WMColor *WMGrayColor(WMScreen *scr);
 598
 599 WMColor *WMBlackColor(WMScreen *scr);
 600
 601 WMColor *WMWhiteColor(WMScreen *scr);
 602
 603 void WMSetColorInGC(WMColor *color, GC gc);
 604
 605 GC WMColorGC(WMColor *color);
 606
 607 WMPixel WMColorPixel(WMColor *color);
 608
 609 void WMPaintColorSwatch(WMColor *color, Drawable d, int x, int y,
 610                         unsigned int width, unsigned int height);
 611
 612 void WMReleaseColor(WMColor *color);
 613
 614 WMColor *WMRetainColor(WMColor *color);
 615
 616 WMColor *WMCreateRGBColor(WMScreen *scr, unsigned short red,
 617                           unsigned short green, unsigned short blue,
 618                           Bool exact);
 619
 620 WMColor *WMCreateNamedColor(WMScreen *scr, char *name, Bool exact);
 621
 622 unsigned short WMRedComponentOfColor(WMColor *color);
 623
 624 unsigned short WMGreenComponentOfColor(WMColor *color);
 625
 626 unsigned short WMBlueComponentOfColor(WMColor *color);
 627
 628 char *WMGetColorRGBDescription(WMColor *color);
 629
 630 /* ....................................................................... */
 631
 632
 633 void WMDrawString(WMScreen *scr, Drawable d, GC gc, WMFont *font, int x,
 634                   int y, char *text, int length);
 635
 636 void WMDrawImageString(WMScreen *scr, Drawable d, GC gc, WMFont *font, int x,
 637                        int y, char *text, int length);
 638
 639 int WMWidthOfString(WMFont *font, char *text, int length);
 640
 641
 642
 643 /* ....................................................................... */
 644
 645 WMScreen *WMWidgetScreen(WMWidget *w);
 646
 647 void WMUnmapWidget(WMWidget *w);
 648
 649 void WMMapWidget(WMWidget *w);
 650
 651 void WMMoveWidget(WMWidget *w, int x, int y);
 652
 653 void WMResizeWidget(WMWidget *w, unsigned int width, unsigned int height);
 654
 655 void WMSetWidgetBackgroundColor(WMWidget *w, WMColor *color);
 656
 657 void WMMapSubwidgets(WMWidget *w);
 658
 659 void WMUnmapSubwidgets(WMWidget *w);
 660
 661 void WMRealizeWidget(WMWidget *w);
 662
 663 void WMDestroyWidget(WMWidget *widget);
 664
 665 void WMHangData(WMWidget *widget, void *data);
 666
 667 void *WMGetHangedData(WMWidget *widget);
 668
 669 unsigned int WMWidgetWidth(WMWidget *w);
 670
 671 unsigned int WMWidgetHeight(WMWidget *w);
 672
 673 Window WMWidgetXID(WMWidget *w);
 674
 675 Window WMViewXID(WMView *view);
 676
 677 void WMRedisplayWidget(WMWidget *w);
 678
 679 void WMSetViewNotifySizeChanges(WMView *view, Bool flag);
 680
 681 WMSize WMGetViewSize(WMView *view);
 682
 683 WMPoint WMGetViewPosition(WMView *view);
 684
 685 WMWidget *WMWidgetOfView(WMView *view);
 686
 687 /* notifications */
 688 extern char *WMViewSizeDidChangeNotification;
 689
 690 extern char *WMViewRealizedNotification;
 691
 692
 693 /* ....................................................................... */
 694
 695 void WMSetBalloonTextForView(char *text, WMView *view);
 696
 697 void WMSetBalloonTextAlignment(WMScreen *scr, WMAlignment alignment);
 698
 699 void WMSetBalloonFont(WMScreen *scr, WMFont *font);
 700
 701 void WMSetBalloonTextColor(WMScreen *scr, WMColor *color);
 702
 703 void WMSetBalloonDelay(WMScreen *scr, int delay);
 704
 705 void WMSetBalloonEnabled(WMScreen *scr, Bool flag);
 706
 707
 708 /* ....................................................................... */
 709
 710 WMWindow *WMCreateWindow(WMScreen *screen, char *name);
 711
 712 WMWindow *WMCreateWindowWithStyle(WMScreen *screen, char *name, int style);
 713
 714 WMWindow *WMCreatePanelWithStyleForWindow(WMWindow *owner, char *name,
 715                                           int style);
 716
 717 WMWindow *WMCreatePanelForWindow(WMWindow *owner, char *name);
 718
 719 void WMChangePanelOwner(WMWindow *win, WMWindow *newOwner);
 720
 721 void WMSetWindowTitle(WMWindow *wPtr, char *title);
 722
 723 void WMSetWindowMiniwindowTitle(WMWindow *win, char *title);
 724
 725 void WMSetWindowMiniwindowImage(WMWindow *win, WMPixmap *pixmap);
 726
 727 void WMSetWindowCloseAction(WMWindow *win, WMAction *action, void *clientData);
 728
 729 void WMSetWindowUPosition(WMWindow *win, int x, int y);
 730
 731 void WMSetWindowUSize(WMWindow *win, unsigned width, unsigned height);
 732
 733 void WMSetWindowMaxSize(WMWindow *win, unsigned width, unsigned height);
 734
 735 void WMSetWindowMinSize(WMWindow *win, unsigned width, unsigned height);
 736
 737 void WMSetWindowBaseSize(WMWindow *win, unsigned width, unsigned height);
 738
 739 void WMSetWindowResizeIncrements(WMWindow *win, unsigned wIncr, unsigned hIncr);
 740
 741 void WMSetWindowLevel(WMWindow *win, int level);
 742
 743 void WMSetWindowDocumentEdited(WMWindow *win, Bool flag);
 744
 745 void WMCloseWindow(WMWindow *win);
 746
 747 /* ....................................................................... */
 748
 749 void WMSetButtonAction(WMButton *bPtr, WMAction *action, void *clientData);
 750
 751 #define WMCreateCommandButton(parent) \
 752         WMCreateCustomButton((parent), WBBSpringLoadedMask\
 753                                         |WBBPushInMask\
 754                                         |WBBPushLightMask\
 755                                         |WBBPushChangeMask)
 756
 757 #define WMCreateRadioButton(parent) \
 758         WMCreateButton((parent), WBTRadio)
 759
 760 #define WMCreateSwitchButton(parent) \
 761         WMCreateButton((parent), WBTSwitch)
 762
 763 WMButton *WMCreateButton(WMWidget *parent, WMButtonType type);
 764
 765 WMButton *WMCreateCustomButton(WMWidget *parent, int behaviourMask);
 766
 767 void WMSetButtonImage(WMButton *bPtr, WMPixmap *image);
 768
 769 void WMSetButtonAltImage(WMButton *bPtr, WMPixmap *image);
 770
 771 void WMSetButtonImagePosition(WMButton *bPtr, WMImagePosition position);
 772
 773 void WMSetButtonFont(WMButton *bPtr, WMFont *font);
 774
 775 void WMSetButtonTextAlignment(WMButton *bPtr, WMAlignment alignment);
 776
 777 void WMSetButtonText(WMButton *bPtr, char *text);
 778
 779 void WMSetButtonAltText(WMButton *bPtr, char *text);
 780
 781 void WMSetButtonSelected(WMButton *bPtr, int isSelected);
 782
 783 int WMGetButtonSelected(WMButton *bPtr);
 784
 785 void WMSetButtonBordered(WMButton *bPtr, int isBordered);
 786
 787 void WMSetButtonEnabled(WMButton *bPtr, Bool flag);
 788
 789 void WMSetButtonImageDimsWhenDisabled(WMButton *bPtr, Bool flag);
 790
 791 void WMSetButtonTag(WMButton *bPtr, int tag);
 792
 793 void WMGroupButtons(WMButton *bPtr, WMButton *newMember);
 794
 795 void WMPerformButtonClick(WMButton *bPtr);
 796
 797 void WMSetButtonContinuous(WMButton *bPtr, Bool flag);
 798
 799 void WMSetButtonPeriodicDelay(WMButton *bPtr, float delay, float interval);
 800
 801 /* ....................................................................... */
 802
 803 WMLabel *WMCreateLabel(WMWidget *parent);
 804
 805 void WMSetLabelWraps(WMLabel *lPtr, Bool flag);
 806
 807 void WMSetLabelImage(WMLabel *lPtr, WMPixmap *image);
 808
 809 WMPixmap *WMGetLabelImage(WMLabel *lPtr);
 810
 811 void WMSetLabelImagePosition(WMLabel *lPtr, WMImagePosition position);
 812
 813 void WMSetLabelTextAlignment(WMLabel *lPtr, WMAlignment alignment);
 814
 815 void WMSetLabelRelief(WMLabel *lPtr, WMReliefType relief);
 816
 817 void WMSetLabelText(WMLabel *lPtr, char *text);
 818
 819 void WMSetLabelFont(WMLabel *lPtr, WMFont *font);
 820
 821 void WMSetLabelTextColor(WMLabel *lPtr, WMColor *color);
 822
 823 /* ....................................................................... */
 824
 825 WMFrame *WMCreateFrame(WMWidget *parent);
 826
 827 void WMSetFrameTitlePosition(WMFrame *fPtr, WMTitlePosition position);
 828
 829 void WMSetFrameRelief(WMFrame *fPtr, WMReliefType relief);
 830
 831 void WMSetFrameTitle(WMFrame *fPtr, char *title);
 832
 833 /* ....................................................................... */
 834
 835 WMTextField *WMCreateTextField(WMWidget *parent);
 836
 837 void WMInsertTextFieldText(WMTextField *tPtr, char *text, int position);
 838
 839 void WMDeleteTextFieldRange(WMTextField *tPtr, WMRange range);
 840
 841 /* you can free the returned string */
 842 char *WMGetTextFieldText(WMTextField *tPtr);
 843
 844 void WMSetTextFieldText(WMTextField *tPtr, char *text);
 845
 846 void WMSetTextFieldAlignment(WMTextField *tPtr, WMAlignment alignment);
 847
 848 void WMSetTextFieldBordered(WMTextField *tPtr, Bool bordered);
 849
 850 void WMSetTextFieldBeveled(WMTextField *tPtr, Bool flag);
 851
 852 Bool WMGetTextFieldEditable(WMTextField *tPtr);
 853
 854 void WMSetTextFieldEditable(WMTextField *tPtr, Bool flag);
 855
 856 void WMSetTextFieldSecure(WMTextField *tPtr, Bool flag);
 857
 858 void WMSelectTextFieldRange(WMTextField *tPtr, WMRange range);
 859
 860 void WMSetTextFieldCursorPosition(WMTextField *tPtr, unsigned int position);
 861
 862 void WMSetTextFieldNextTextField(WMTextField *tPtr, WMTextField *next);
 863
 864 void WMSetTextFieldPrevTextField(WMTextField *tPtr, WMTextField *prev);
 865
 866
 867 extern char *WMTextDidChangeNotification;
 868 extern char *WMTextDidBeginEditingNotification;
 869 extern char *WMTextDidEndEditingNotification;
 870
 871 /* ....................................................................... */
 872
 873 WMScroller *WMCreateScroller(WMWidget *parent);
 874
 875 void WMSetScrollerParameters(WMScroller *sPtr, float floatValue,
 876                              float knobProportion);
 877
 878 float WMGetScrollerKnobProportion(WMScroller *sPtr);
 879
 880 float WMGetScrollerValue(WMScroller *sPtr);
 881
 882 WMScrollerPart WMGetScrollerHitPart(WMScroller *sPtr);
 883
 884 void WMSetScrollerAction(WMScroller *sPtr, WMAction *action, void *clientData);
 885
 886 void WMSetScrollerArrowsPosition(WMScroller *sPtr,
 887                                  WMScrollArrowPosition position);
 888
 889 /* ....................................................................... */
 890
 891 WMList *WMCreateList(WMWidget *parent);
 892
 893 #define WMAddListItem(lPtr, text) WMInsertListItem((lPtr), -1, (text))
 894
 895 WMListItem *WMInsertListItem(WMList *lPtr, int row, char *text);
 896
 897 WMListItem *WMAddSortedListItem(WMList *lPtr, char *text);
 898
 899 int WMFindRowOfListItemWithTitle(WMList *lPtr, char *title);
 900
 901 WMListItem *WMGetListItem(WMList *lPtr, int row);
 902
 903 void WMRemoveListItem(WMList *lPtr, int row);
 904
 905 void WMSelectListItem(WMList *lPtr, int row);
 906
 907 void WMSetListUserDrawProc(WMList *lPtr, WMListDrawProc *proc);
 908
 909 void WMSetListUserDrawItemHeight(WMList *lPtr, unsigned short height);
 910
 911 int WMGetListItemHeight(WMList *lPtr);
 912
 913 /* don't free the returned data */
 914 WMListItem *WMGetListSelectedItem(WMList *lPtr);
 915
 916 int WMGetListSelectedItemRow(WMList *lPtr);
 917
 918 void WMSetListAction(WMList *lPtr, WMAction *action, void *clientData);
 919
 920 void WMSetListDoubleAction(WMList *lPtr, WMAction *action, void *clientData);
 921
 922 void WMClearList(WMList *lPtr);
 923
 924 int WMGetListNumberOfRows(WMList *lPtr);
 925
 926 void WMSetListPosition(WMList *lPtr, int row);
 927
 928 void WMSetListBottomPosition(WMList *lPtr, int row);
 929
 930 int WMGetListPosition(WMList *lPtr);
 931
 932 extern char *WMListDidScrollNotification;
 933 extern char *WMListSelectionDidChangeNotification;
 934
 935 /* ....................................................................... */
 936
 937 WMBrowser *WMCreateBrowser(WMWidget *parent);
 938
 939 void WMSetBrowserPathSeparator(WMBrowser *bPtr, char *separator);
 940
 941 void WMSetBrowserTitled(WMBrowser *bPtr, Bool flag);
 942
 943 void WMLoadBrowserColumnZero(WMBrowser *bPtr);
 944
 945 int WMAddBrowserColumn(WMBrowser *bPtr);
 946
 947 void WMRemoveBrowserItem(WMBrowser *bPtr, int column, int row);
 948
 949 void WMSetBrowserMaxVisibleColumns(WMBrowser *bPtr, int columns);
 950
 951 void WMSetBrowserColumnTitle(WMBrowser *bPtr, int column, char *title);
 952
 953 WMListItem *WMAddSortedBrowserItem(WMBrowser *bPtr, int column, char *text, Bool isBranch);
 954
 955 WMListItem *WMInsertBrowserItem(WMBrowser *bPtr, int column, int row, char *text, Bool isBranch);
 956
 957 /* Don't free the returned string. */
 958 char* WMSetBrowserPath(WMBrowser *bPtr, char *path);
 959
 960 /* you can free the returned string */
 961 char *WMGetBrowserPath(WMBrowser *bPtr);
 962 /* you can free the returned string */
 963 char *WMGetBrowserPathToColumn(WMBrowser *bPtr, int column);
 964
 965 void WMSetBrowserAction(WMBrowser *bPtr, WMAction *action, void *clientData);
 966
 967 void WMSetBrowserDoubleAction(WMBrowser *bPtr, WMAction *action,
 968                               void *clientData);
 969
 970 WMListItem *WMGetBrowserSelectedItemInColumn(WMBrowser *bPtr, int column);
 971
 972 int WMGetBrowserFirstVisibleColumn(WMBrowser *bPtr);
 973
 974 int WMGetBrowserSelectedColumn(WMBrowser *bPtr);
 975
 976 int WMGetBrowserSelectedRowInColumn(WMBrowser *bPtr, int column);
 977
 978 int WMGetBrowserNumberOfColumns(WMBrowser *bPtr);
 979
 980 int WMGetBrowserMaxVisibleColumns(WMBrowser *bPtr);
 981
 982 WMList *WMGetBrowserListInColumn(WMBrowser *bPtr, int column);
 983
 984 void WMSetBrowserDelegate(WMBrowser *bPtr, WMBrowserDelegate *delegate);
 985
 986 /* ....................................................................... */
 987
 988 WMPopUpButton *WMCreatePopUpButton(WMWidget *parent);
 989
 990 void WMSetPopUpButtonAction(WMPopUpButton *sPtr, WMAction *action,
 991                             void *clientData);
 992
 993 void WMSetPopUpButtonPullsDown(WMPopUpButton *bPtr, Bool flag);
 994
 995 void WMAddPopUpButtonItem(WMPopUpButton *bPtr, char *title);
 996
 997 void WMInsertPopUpButtonItem(WMPopUpButton *bPtr, int index, char *title);
 998
 999 void WMRemovePopUpButtonItem(WMPopUpButton *bPtr, int index);
1000
1001 void WMSetPopUpButtonItemEnabled(WMPopUpButton *bPtr, int index, Bool flag);
1002
1003 void WMSetPopUpButtonSelectedItem(WMPopUpButton *bPtr, int index);
1004
1005 int WMGetPopUpButtonSelectedItem(WMPopUpButton *bPtr);
1006
1007 void WMSetPopUpButtonText(WMPopUpButton *bPtr, char *text);
1008
1009 /* don't free the returned data */
1010 char *WMGetPopUpButtonItem(WMPopUpButton *bPtr, int index);
1011
1012 int WMGetPopUpButtonNumberOfItems(WMPopUpButton *bPtr);
1013
1014 void WMSetPopUpButtonEnabled(WMPopUpButton *bPtr, Bool flag);
1015
1016 /* ....................................................................... */
1017
1018 WMColorPanel *WMGetColorPanel(WMScreen *scrPtr);
1019
1020 void WMFreeColorPanel(WMColorPanel *panel);
1021
1022 void WMShowColorPanel(WMColorPanel *panel);
1023
1024 void WMCloseColorPanel(WMColorPanel *panel);
1025
1026 void WMSetColorPanelColor(WMColorPanel *panel, WMColor *color);
1027
1028 void WMSetColorPanelPickerMode(WMColorPanel *panel, WMColorPanelMode mode);
1029
1030 void WMSetColorPanelAction(WMColorPanel *panel, WMAction2 *action, void *data);
1031
1032 extern char *WMColorPanelColorChangedNotification;
1033
1034 /* ....................................................................... */
1035
1036 WMColorWell *WMCreateColorWell(WMWidget *parent);
1037
1038 void WMSetColorWellColor(WMColorWell *cPtr, WMColor *color);
1039
1040 WMColor *WMGetColorWellColor(WMColorWell *cPtr);
1041
1042 void WSetColorWellBordered(WMColorWell *cPtr, Bool flag);
1043
1044
1045 extern char *WMColorWellDidChangeNotification;
1046
1047
1048 /* ...................................................................... */
1049
1050 WMScrollView *WMCreateScrollView(WMWidget *parent);
1051
1052 void WMResizeScrollViewContent(WMScrollView *sPtr, unsigned int width,
1053                                unsigned int height);
1054
1055 void WMSetScrollViewHasHorizontalScroller(WMScrollView *sPtr, Bool flag);
1056
1057 void WMSetScrollViewHasVerticalScroller(WMScrollView *sPtr, Bool flag);
1058
1059 void WMSetScrollViewContentView(WMScrollView *sPtr, WMView *view);
1060
1061 void WMSetScrollViewRelief(WMScrollView *sPtr, WMReliefType type);
1062
1063 void WMSetScrollViewContentView(WMScrollView *sPtr, WMView *view);
1064
1065 WMScroller *WMGetScrollViewHorizontalScroller(WMScrollView *sPtr);
1066
1067 WMScroller *WMGetScrollViewVerticalScroller(WMScrollView *sPtr);
1068
1069 void WMSetScrollViewLineScroll(WMScrollView *sPtr, int amount);
1070
1071 void WMSetScrollViewPageScroll(WMScrollView *sPtr, int amount);
1072
1073 /* ....................................................................... */
1074
1075 WMSlider *WMCreateSlider(WMWidget *parent);
1076
1077 int WMGetSliderMinValue(WMSlider *slider);
1078
1079 int WMGetSliderMaxValue(WMSlider *slider);
1080
1081 int WMGetSliderValue(WMSlider *slider);
1082
1083 void WMSetSliderMinValue(WMSlider *slider, int value);
1084
1085 void WMSetSliderMaxValue(WMSlider *slider, int value);
1086
1087 void WMSetSliderValue(WMSlider *slider, int value);
1088
1089 void WMSetSliderContinuous(WMSlider *slider, Bool flag);
1090
1091 void WMSetSliderAction(WMSlider *slider, WMAction *action, void *data);
1092
1093 void WMSetSliderKnobThickness(WMSlider *sPtr, int thickness);
1094
1095 void WMSetSliderImage(WMSlider *sPtr, WMPixmap *pixmap);
1096
1097 /* ....................................................................... */
1098
1099 /* only supports 2 subviews */
1100 WMSplitView *WMCreateSplitView(WMWidget *parent);
1101
1102 void WMAddSplitViewSubview(WMSplitView *sPtr, WMView *subview);
1103
1104 void WMAdjustSplitViewSubviews(WMSplitView *sPtr);
1105
1106 void WMSetSplitViewConstrainProc(WMSplitView *sPtr,
1107                                  WMSplitViewConstrainProc *proc);
1108
1109 /*
1110 void WMSetSplitViewResizeSubviewsProc(WMSplitView *sPtr,
1111                                       WMSplitViewResizeSubviewsProc *proc);
1112 */
1113
1114 int WMGetSplitViewDividerThickness(WMSplitView *sPtr);
1115
1116
1117 /* ....................................................................... */
1118
1119
1120 WMTabView *WMCreateTabView(WMWidget *parent);
1121
1122 void WMSetTabViewFont(WMTabView *tPtr, WMFont *font);
1123
1124 void WMAddItemInTabView(WMTabView *tPtr, WMTabViewItem *item);
1125
1126 void WMInsertItemInTabView(WMTabView *tPtr, int index, WMTabViewItem *item);
1127
1128 void WMRemoveTabViewItem(WMTabView *tPtr, WMTabViewItem *item);
1129
1130 WMTabViewItem *WMTabViewItemAtPoint(WMTabView *tPtr, int x, int y);
1131
1132 void WMSelectFirstTabViewItem(WMTabView *tPtr);
1133
1134 void WMSelectLastTabViewItem(WMTabView *tPtr);
1135
1136 void WMSelectNextTabViewItem(WMTabView *tPtr);
1137
1138 void WMSelectPreviousTabViewItem(WMTabView *tPtr);
1139
1140 WMTabViewItem *WMGetSelectedTabViewItem(WMTabView *tPtr);
1141
1142 void WMSelectTabViewItem(WMTabView *tPtr, WMTabViewItem *item);
1143
1144 void WMSelectTabViewItemAtIndex(WMTabView *tPtr, int index);
1145
1146
1147
1148 WMTabViewItem *WMCreateTabViewItemWithIdentifier(int identifier);
1149
1150 void WMSetTabViewItemLabel(WMTabViewItem *item, char *label);
1151
1152 char *WMGetTabViewItemLabel(WMTabViewItem *item);
1153
1154 void WMSetTabViewItemView(WMTabViewItem *item, WMView *view);
1155
1156 WMView *WMGetTabViewItemView(WMTabViewItem *item);
1157
1158 void WMDestroyTabViewItem(WMTabViewItem *item);
1159
1160 /* ....................................................................... */
1161
1162 int WMRunAlertPanel(WMScreen *app, WMWindow *owner, char *title, char *msg,
1163                     char *defaultButton, char *alternateButton,
1164                     char *otherButton);
1165
1166 /* you can free the returned string */
1167 char *WMRunInputPanel(WMScreen *app, WMWindow *owner, char *title, char *msg,
1168                       char *defaultText, char *okButton, char *cancelButton);
1169
1170 WMAlertPanel *WMCreateAlertPanel(WMScreen *app, WMWindow *owner, char *title,
1171                                  char *msg, char *defaultButton,
1172                                  char *alternateButton, char *otherButton);
1173
1174 WMInputPanel *WMCreateInputPanel(WMScreen *app, WMWindow *owner, char *title,
1175                                  char *msg, char *defaultText, char *okButton,
1176                                  char *cancelButton);
1177
1178 void WMDestroyAlertPanel(WMAlertPanel *panel);
1179
1180 void WMDestroyInputPanel(WMInputPanel *panel);
1181
1182 /* ....................................................................... */
1183
1184 /* only 1 instance per WMScreen */
1185 WMOpenPanel *WMGetOpenPanel(WMScreen *scrPtr);
1186
1187 WMSavePanel *WMGetSavePanel(WMScreen *scrPtr);
1188
1189 void WMSetFilePanelCanChooseDirectories(WMFilePanel *panel, Bool flag);
1190
1191 void WMSetFilePanelCanChooseFiles(WMFilePanel *panel, Bool flag);
1192
1193 void WMSetFilePanelAutoCompletion(WMFilePanel *panel, Bool flag);
1194
1195 void WMSetFilePanelDirectory(WMFilePanel *panel, char *path);
1196
1197 /* you can free the returned string */
1198 char *WMGetFilePanelFileName(WMFilePanel *panel);
1199
1200 void WMFreeFilePanel(WMFilePanel *panel);
1201
1202 int WMRunModalFilePanelForDirectory(WMFilePanel *panel, WMWindow *owner,
1203                                     char *path, char *name, char **fileTypes);
1204
1205 void WMSetFilePanelAccessoryView(WMFilePanel *panel, WMView *view);
1206
1207 WMView *WMGetFilePanelAccessoryView(WMFilePanel *panel);
1208
1209
1210 /* ...................................................................... */
1211
1212 /* only 1 instance per WMScreen */
1213 WMFontPanel *WMGetFontPanel(WMScreen *scr);
1214
1215 void WMShowFontPanel(WMFontPanel *panel);
1216
1217 void WMHideFontPanel(WMFontPanel *panel);
1218
1219 void WMSetFontPanelFont(WMFontPanel *panel, WMFont *font);
1220
1221 /* you can free the returned string */
1222 char *WMGetFontPanelFontName(WMFontPanel *panel);
1223
1224 WMFont *WMGetFontPanelFont(WMFontPanel *panel);
1225
1226 #ifdef __cplusplus
1227 }
1228 #endif /* __cplusplus */
1229
1230 #endif
1231