WINGs/WINGs/WINGs.h

   1
   2
   3 #ifndef _WINGS_H_
   4 #define _WINGS_H_
   5
   6 #include <wraster.h>
   7 #include <WINGs/WUtil.h>
   8 #include <X11/Xlib.h>
   9
  10 #define WINGS_H_VERSION  20010117
  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
  40 /* WMRange was moved in WUtil.h */
  41
  42 #define ClientMessageMask       (1L<<30)
  43
  44
  45 #ifndef _DEFINED_GNUSTEP_WINDOW_INFO
  46 #define _DEFINED_GNUSTEP_WINDOW_INFO
  47 /*
  48  * Window levels are taken from GNUstep (gui/AppKit/NSWindow.h)
  49  * NSDesktopWindowLevel intended to be the level at which things
  50  * on the desktop sit ... so you should be able
  51  * to put a desktop background just below it.
  52  *
  53  * Applications are actually permitted to use any value in the
  54  * range INT_MIN+1 to INT_MAX
  55  */
  56 enum {
  57   WMDesktopWindowLevel = -1000, /* GNUstep addition     */
  58   WMNormalWindowLevel = 0,
  59   WMFloatingWindowLevel = 3,
  60   WMSubmenuWindowLevel = 3,
  61   WMTornOffMenuWindowLevel = 3,
  62   WMMainMenuWindowLevel = 20,
  63   WMDockWindowLevel = 21,       /* Deprecated - use NSStatusWindowLevel */
  64   WMStatusWindowLevel = 21,
  65   WMModalPanelWindowLevel = 100,
  66   WMPopUpMenuWindowLevel = 101,
  67   WMScreenSaverWindowLevel = 1000
  68 };
  69
  70
  71 /* window attributes */
  72 enum {
  73   WMBorderlessWindowMask = 0,
  74   WMTitledWindowMask = 1,
  75   WMClosableWindowMask = 2,
  76   WMMiniaturizableWindowMask = 4,
  77   WMResizableWindowMask = 8,
  78   WMIconWindowMask = 64,
  79   WMMiniWindowMask = 128
  80 };
  81 #endif
  82
  83
  84 /* button types */
  85 typedef enum {
  86     /* 0 is reserved for internal use */
  87         WBTMomentaryPush = 1,
  88         WBTPushOnPushOff = 2,
  89         WBTToggle = 3,
  90         WBTSwitch = 4,
  91         WBTRadio = 5,
  92         WBTMomentaryChange = 6,
  93         WBTOnOff = 7,
  94         WBTMomentaryLight = 8
  95 } WMButtonType;
  96
  97 /* button behaviour masks */
  98 enum {
  99     WBBSpringLoadedMask =       (1 << 0),
 100         WBBPushInMask =         (1 << 1),
 101         WBBPushChangeMask =     (1 << 2),
 102         WBBPushLightMask =      (1 << 3),
 103         WBBStateLightMask =     (1 << 5),
 104         WBBStateChangeMask =    (1 << 6),
 105         WBBStatePushMask =      (1 << 7)
 106 };
 107
 108
 109 /* frame title positions */
 110 typedef enum {
 111     WTPNoTitle,
 112         WTPAboveTop,
 113         WTPAtTop,
 114         WTPBelowTop,
 115         WTPAboveBottom,
 116         WTPAtBottom,
 117         WTPBelowBottom
 118 } WMTitlePosition;
 119
 120
 121 /* relief types */
 122 typedef enum {
 123     WRFlat,
 124         WRSimple,
 125         WRRaised,
 126         WRSunken,
 127         WRGroove,
 128         WRRidge,
 129         WRPushed
 130 } WMReliefType;
 131
 132
 133 /* alignment types */
 134 typedef enum {
 135     WALeft,
 136         WACenter,
 137         WARight,
 138         WAJustified                    /* not valid for textfields */
 139 } WMAlignment;
 140
 141
 142 /* image position */
 143 typedef enum {
 144     WIPNoImage,
 145     WIPImageOnly,
 146     WIPLeft,
 147     WIPRight,
 148     WIPBelow,
 149     WIPAbove,
 150     WIPOverlaps
 151 } WMImagePosition;
 152
 153
 154 /* scroller arrow position */
 155 typedef enum {
 156     WSAMaxEnd,
 157         WSAMinEnd,
 158         WSANone
 159 } WMScrollArrowPosition;
 160
 161 /* scroller parts */
 162 typedef enum {
 163     WSNoPart,
 164         WSDecrementPage,
 165         WSIncrementPage,
 166         WSDecrementLine,
 167         WSIncrementLine,
 168         WSDecrementWheel,
 169         WSIncrementWheel,
 170         WSKnob,
 171         WSKnobSlot
 172 } WMScrollerPart;
 173
 174 /* usable scroller parts */
 175 typedef enum {
 176     WSUNoParts,
 177         WSUOnlyArrows,
 178         WSUAllParts
 179 } WMUsableScrollerParts;
 180
 181 /* matrix types */
 182 typedef enum {
 183     WMRadioMode,
 184         WMHighlightMode,
 185         WMListMode,
 186         WMTrackMode
 187 } WMMatrixTypes;
 188
 189
 190 typedef enum {
 191     WTTopTabsBevelBorder,
 192         WTNoTabsBevelBorder,
 193         WTNoTabsLineBorder,
 194         WTNoTabsNoBorder
 195 } WMTabViewType;
 196
 197
 198 /* text movement types */
 199 enum {
 200     WMIllegalTextMovement,
 201         WMReturnTextMovement,
 202         WMEscapeTextMovement,
 203         WMTabTextMovement,
 204         WMBacktabTextMovement,
 205         WMLeftTextMovement,
 206         WMRightTextMovement,
 207         WMUpTextMovement,
 208         WMDownTextMovement
 209 };
 210
 211 /* text field special events */
 212 enum {
 213     WMInsertTextEvent,
 214     WMDeleteTextEvent
 215 };
 216
 217
 218 enum {
 219     WLNotFound = -1       /* element was not found in WMList */
 220 };
 221
 222
 223 /* drag operations */
 224 typedef enum {
 225     WDOperationNone,
 226     WDOperationCopy,
 227     WDOperationMove,
 228     WDOperationLink,
 229     WDOperationAsk,
 230     WDOperationPrivate
 231 } WMDragOperationType;
 232
 233
 234 typedef enum {
 235         WMGrayModeColorPanel = 1,
 236         WMRGBModeColorPanel = 2,
 237         WMCMYKModeColorPanel = 3,
 238         WMHSBModeColorPanel = 4,
 239         WMCustomPaletteModeColorPanel = 5,
 240         WMColorListModeColorPanel = 6,
 241         WMWheelModeColorPanel = 7
 242 } WMColorPanelMode;
 243
 244
 245
 246 /* system images */
 247 #define WSIReturnArrow                  1
 248 #define WSIHighlightedReturnArrow       2
 249 #define WSIScrollerDimple               3
 250 #define WSIArrowLeft                    4
 251 #define WSIHighlightedArrowLeft         5
 252 #define WSIArrowRight                   6
 253 #define WSIHighlightedArrowRight        7
 254 #define WSIArrowUp                      8
 255 #define WSIHighlightedArrowUp           9
 256 #define WSIArrowDown                    10
 257 #define WSIHighlightedArrowDown         11
 258 #define WSICheckMark                    12
 259
 260 enum {
 261     WLDSSelected = (1 << 16),
 262         WLDSDisabled = (1 << 17),
 263         WLDSFocused = (1 << 18),
 264         WLDSIsBranch = (1 << 19)
 265 };
 266
 267 /* alert panel return values */
 268 enum {
 269     WAPRDefault = 0,
 270         WAPRAlternate = 1,
 271         WAPROther = -1,
 272         WAPRError = -2
 273 };
 274
 275
 276
 277 /* types of input observers */
 278 enum {
 279     WIReadMask = (1 << 0),
 280         WIWriteMask = (1 << 1),
 281         WIExceptMask = (1 << 2)
 282 };
 283
 284
 285
 286 typedef int W_Class;
 287
 288 enum {
 289     WC_Window = 0,
 290     WC_Frame = 1,
 291     WC_Label = 2,
 292     WC_Button = 3,
 293     WC_TextField = 4,
 294     WC_Scroller = 5,
 295     WC_ScrollView = 6,
 296     WC_List = 7,
 297     WC_Browser = 8,
 298     WC_PopUpButton = 9,
 299     WC_ColorWell = 10,
 300     WC_Slider = 11,
 301     WC_Matrix = 12,                    /* not ready */
 302     WC_SplitView = 13,
 303     WC_TabView = 14,
 304     WC_ProgressIndicator = 15,
 305     WC_MenuView = 16,
 306     WC_Ruler = 17,
 307     WC_Text = 18,
 308     WC_Box = 19
 309 };
 310
 311 /* All widgets must start with the following structure
 312  * in that order. Used for typecasting to get some generic data */
 313 typedef struct W_WidgetType {
 314     W_Class widgetClass;
 315     struct W_View *view;
 316
 317 } W_WidgetType;
 318
 319
 320 #define WMWidgetClass(widget)   (((W_WidgetType*)(widget))->widgetClass)
 321 #define WMWidgetView(widget)    (((W_WidgetType*)(widget))->view)
 322
 323
 324 /* widgets */
 325
 326 typedef void WMWidget;
 327
 328 typedef struct W_Pixmap WMPixmap;
 329 typedef struct W_Font   WMFont;
 330 typedef struct W_Color  WMColor;
 331
 332 typedef struct W_Screen WMScreen;
 333
 334 typedef struct W_View WMView;
 335
 336 typedef struct W_Window WMWindow;
 337 typedef struct W_Frame WMFrame;
 338 typedef struct W_Button WMButton;
 339 typedef struct W_Label WMLabel;
 340 typedef struct W_TextField WMTextField;
 341 typedef struct W_Scroller WMScroller;
 342 typedef struct W_ScrollView WMScrollView;
 343 typedef struct W_List WMList;
 344 typedef struct W_Browser WMBrowser;
 345 typedef struct W_PopUpButton WMPopUpButton;
 346 typedef struct W_ProgressIndicator WMProgressIndicator;
 347 typedef struct W_ColorWell WMColorWell;
 348 typedef struct W_Slider WMSlider;
 349 typedef struct W_Matrix WMMatrix;      /* not ready */
 350 typedef struct W_SplitView WMSplitView;
 351 typedef struct W_TabView WMTabView;
 352 typedef struct W_Ruler WMRuler;
 353 typedef struct W_Text WMText;
 354 typedef struct W_Box WMBox;
 355
 356
 357 /* not widgets */
 358 typedef struct W_TabViewItem WMTabViewItem;
 359 typedef struct W_MenuItem WMMenuItem;
 360
 361
 362 typedef struct W_FilePanel WMFilePanel;
 363 typedef WMFilePanel WMOpenPanel;
 364 typedef WMFilePanel WMSavePanel;
 365
 366 typedef struct W_FontPanel WMFontPanel;
 367
 368 typedef struct W_ColorPanel WMColorPanel;
 369
 370
 371 /* item for WMList */
 372 typedef struct WMListItem {
 373     char *text;
 374     void *clientData;                  /* ptr for user clientdata. */
 375
 376     unsigned int uflags:16;            /* flags for the user */
 377     unsigned int selected:1;
 378     unsigned int disabled:1;
 379     unsigned int isBranch:1;
 380     unsigned int loaded:1;
 381 } WMListItem;
 382
 383 /* struct for message panel */
 384 typedef struct WMAlertPanel {
 385     WMWindow *win;                     /* window */
 386     WMBox *vbox;
 387     WMButton *defBtn;                  /* default button */
 388     WMButton *altBtn;                  /* alternative button */
 389     WMButton *othBtn;                  /* other button */
 390     WMLabel *iLbl;                     /* icon label */
 391     WMLabel *tLbl;                     /* title label */
 392     WMLabel *mLbl;                     /* message label */
 393     WMFrame *line;                     /* separator */
 394     short result;                      /* button that was pushed */
 395     short done;
 396 } WMAlertPanel;
 397
 398
 399 typedef struct WMGenericPanel {
 400     WMWindow *win;
 401     WMBox *vbox;
 402
 403     WMLabel *iLbl;
 404     WMLabel *tLbl;
 405
 406     WMFrame *line;
 407
 408     WMFrame *content;
 409
 410     WMBox *buttonBox;
 411     WMButton *defBtn;
 412     WMButton *altBtn;
 413
 414     short result;
 415     short done;
 416 } WMGenericPanel;
 417
 418
 419
 420
 421 typedef struct WMInputPanel {
 422     WMWindow *win;                     /* window */
 423     WMButton *defBtn;                  /* default button */
 424     WMButton *altBtn;                  /* alternative button */
 425     WMLabel *tLbl;                     /* title label */
 426     WMLabel *mLbl;                     /* message label */
 427     WMTextField *text;                 /* text field */
 428     short result;                      /* button that was pushed */
 429     short done;
 430 } WMInputPanel;
 431
 432
 433 /* WMRuler: */
 434 typedef struct {
 435     WMArray  *tabs;             /* a growable array of tabstops */
 436     unsigned short left;        /* left margin marker */
 437     unsigned short right;       /* right margin marker */
 438     unsigned short first;       /* indentation marker for first line only */
 439     unsigned short body;        /* body indentation marker */
 440     unsigned short retainCount;
 441 } WMRulerMargins;
 442 /* All indentation and tab markers are _relative_ to the left margin marker */
 443
 444
 445 typedef void *WMHandlerID;
 446
 447 typedef void WMInputProc(int fd, int mask, void *clientData);
 448
 449 typedef void WMEventProc(XEvent *event, void *clientData);
 450
 451 typedef void WMEventHook(XEvent *event);
 452
 453 /* self is set to the widget from where the callback is being called and
 454  * clientData to the data set to with WMSetClientData() */
 455 typedef void WMAction(WMWidget *self, void *clientData);
 456
 457 /* same as WMAction, but for stuff that arent widgets */
 458 typedef void WMAction2(void *self, void *clientData);
 459
 460
 461 typedef void WMCallback(void *data);
 462
 463 typedef void WMDropDataCallback(WMView *view, WMData *data);
 464
 465 /* delegate method like stuff */
 466 typedef void WMListDrawProc(WMList *lPtr, int index, Drawable d, char *text,
 467                             int state, WMRect *rect);
 468
 469 /*
 470 typedef void WMSplitViewResizeSubviewsProc(WMSplitView *sPtr,
 471                                            unsigned int oldWidth,
 472                                            unsigned int oldHeight);
 473 */
 474
 475 typedef void WMSplitViewConstrainProc(WMSplitView *sPtr, int dividerIndex,
 476                                       int *minSize, int *maxSize);
 477
 478 typedef WMWidget *WMMatrixCreateCellProc(WMMatrix *mPtr);
 479
 480
 481
 482
 483 typedef struct WMBrowserDelegate {
 484     void *data;
 485
 486     void (*createRowsForColumn)(struct WMBrowserDelegate *self,
 487                                 WMBrowser *sender, int column, WMList *list);
 488
 489     char* (*titleOfColumn)(struct WMBrowserDelegate *self, WMBrowser *sender,
 490                            int column);
 491
 492     void (*didScroll)(struct WMBrowserDelegate *self, WMBrowser *sender);
 493
 494     void (*willScroll)(struct WMBrowserDelegate *self, WMBrowser *sender);
 495 } WMBrowserDelegate;
 496
 497
 498 typedef struct WMTextFieldDelegate {
 499     void *data;
 500
 501     void (*didBeginEditing)(struct WMTextFieldDelegate *self,
 502                             WMNotification *notif);
 503
 504     void (*didChange)(struct WMTextFieldDelegate *self,
 505                       WMNotification *notif);
 506
 507     void (*didEndEditing)(struct WMTextFieldDelegate *self,
 508                           WMNotification *notif);
 509
 510     Bool (*shouldBeginEditing)(struct WMTextFieldDelegate *self,
 511                                WMTextField *tPtr);
 512
 513     Bool (*shouldEndEditing)(struct WMTextFieldDelegate *self,
 514                              WMTextField *tPtr);
 515 } WMTextFieldDelegate;
 516
 517
 518 typedef struct WMTextDelegate {
 519     void *data;
 520
 521     Bool (*didDoubleClickOnPicture)(struct WMTextDelegate *self,
 522                             void *description);
 523
 524 } WMTextDelegate;
 525
 526
 527
 528 typedef struct WMTabViewDelegate {
 529     void *data;
 530
 531     void (*didChangeNumberOfItems)(struct WMTabViewDelegate *self,
 532                                    WMTabView *tabView);
 533
 534     void (*didSelectItem)(struct WMTabViewDelegate *self, WMTabView *tabView,
 535                           WMTabViewItem *item);
 536
 537     Bool (*shouldSelectItem)(struct WMTabViewDelegate *self, WMTabView *tabView,
 538                              WMTabViewItem *item);
 539
 540     void (*willSelectItem)(struct WMTabViewDelegate *self, WMTabView *tabView,
 541                            WMTabViewItem *item);
 542 } WMTabViewDelegate;
 543
 544
 545
 546
 547 typedef void WMSelectionCallback(WMView *view, Atom selection, Atom target,
 548                                  Time timestamp, void *cdata, WMData *data);
 549
 550
 551 typedef struct WMSelectionProcs {
 552     WMData* (*convertSelection)(WMView *view, Atom selection, Atom target,
 553                                 void *cdata, Atom *type);
 554     void (*selectionLost)(WMView *view, Atom selection, void *cdata);
 555     void (*selectionDone)(WMView *view, Atom selection, Atom target,
 556                           void *cdata);
 557 } WMSelectionProcs;
 558
 559
 560 typedef struct W_DraggingInfo WMDraggingInfo;
 561
 562
 563 typedef struct W_DragSourceProcs {
 564     unsigned (*draggingSourceOperation)(WMView *self, Bool local);
 565     void (*beganDragImage)(WMView *self, WMPixmap *image, WMPoint point);
 566     void (*endedDragImage)(WMView *self, WMPixmap *image, WMPoint point,
 567                            Bool deposited);
 568     WMData* (*fetchDragData)(WMView *self, char *type);
 569 /*    Bool (*ignoreModifierKeysWhileDragging)(WMView *view);*/
 570 } WMDragSourceProcs;
 571
 572
 573
 574 typedef struct W_DragDestinationProcs {
 575     unsigned (*draggingEntered)(WMView *self, WMDraggingInfo *info);
 576     unsigned (*draggingUpdated)(WMView *self, WMDraggingInfo *info);
 577     void (*draggingExited)(WMView *self, WMDraggingInfo *info);
 578     Bool (*prepareForDragOperation)(WMView *self, WMDraggingInfo *info);
 579     Bool (*performDragOperation)(WMView *self, WMDraggingInfo *info);
 580     void (*concludeDragOperation)(WMView *self, WMDraggingInfo *info);
 581 } WMDragDestinationProcs;
 582
 583
 584
 585 /* ...................................................................... */
 586
 587
 588 WMRange wmkrange(int start, int count);
 589
 590 WMPoint wmkpoint(int x, int y);
 591
 592 WMSize wmksize(unsigned int width, unsigned int height);
 593
 594
 595 /* ....................................................................... */
 596
 597
 598
 599 void WMInitializeApplication(char *applicationName, int *argc, char **argv);
 600
 601 void WMSetResourcePath(char *path);
 602
 603 /* don't free the returned string */
 604 char *WMGetApplicationName();
 605
 606 /* Try to locate resource file. ext may be NULL */
 607 char *WMPathForResourceOfType(char *resource, char *ext);
 608
 609
 610 WMScreen *WMOpenScreen();
 611
 612 WMScreen *WMCreateScreenWithRContext(Display *display, int screen,
 613                                      RContext *context);
 614
 615 WMScreen *WMCreateScreen(Display *display, int screen);
 616
 617 WMScreen *WMCreateSimpleApplicationScreen(Display *display);
 618
 619 void WMScreenMainLoop(WMScreen *scr);
 620
 621 void WMBreakModalLoop(WMScreen *scr);
 622
 623 void WMRunModalLoop(WMScreen *scr, WMView *view);
 624
 625 RContext *WMScreenRContext(WMScreen *scr);
 626
 627 Display *WMScreenDisplay(WMScreen *scr);
 628
 629 int WMScreenDepth(WMScreen *scr);
 630
 631
 632
 633 void WMSetApplicationIconImage(WMScreen *app, WMPixmap *icon);
 634
 635 WMPixmap *WMGetApplicationIconImage(WMScreen *app);
 636
 637 void WMSetApplicationIconWindow(WMScreen *scr, Window window);
 638
 639 void WMSetFocusToWidget(WMWidget *widget);
 640
 641 WMEventHook *WMHookEventHandler(WMEventHook *handler);
 642
 643 int WMHandleEvent(XEvent *event);
 644
 645 Bool WMScreenPending(WMScreen *scr);
 646
 647 void WMCreateEventHandler(WMView *view, unsigned long mask,
 648                           WMEventProc *eventProc, void *clientData);
 649
 650 void WMDeleteEventHandler(WMView *view, unsigned long mask,
 651                           WMEventProc *eventProc, void *clientData);
 652
 653 int WMIsDoubleClick(XEvent *event);
 654
 655 int WMIsTripleClick(XEvent *event);
 656
 657 void WMNextEvent(Display *dpy, XEvent *event);
 658
 659 void WMMaskEvent(Display *dpy, long mask, XEvent *event);
 660
 661 WMHandlerID WMAddTimerHandler(int milliseconds, WMCallback *callback,
 662                               void *cdata);
 663
 664 void WMDeleteTimerWithClientData(void *cdata);
 665
 666 void WMDeleteTimerHandler(WMHandlerID handlerID);
 667
 668 WMHandlerID WMAddIdleHandler(WMCallback *callback, void *cdata);
 669
 670 void WMDeleteIdleHandler(WMHandlerID handlerID);
 671
 672 WMHandlerID WMAddInputHandler(int fd, int condition, WMInputProc *proc,
 673                               void *clientData);
 674
 675 void WMDeleteInputHandler(WMHandlerID handlerID);
 676
 677
 678
 679 Bool WMCreateSelectionHandler(WMView *view, Atom selection, Time timestamp,
 680                               WMSelectionProcs *procs, void *cdata);
 681
 682 void WMDeleteSelectionHandler(WMView *view, Atom selection, Time timestamp);
 683
 684 Bool WMRequestSelection(WMView *view, Atom selection, Atom target,
 685                         Time timestamp, WMSelectionCallback *callback,
 686                         void *cdata);
 687
 688
 689 /* ....................................................................... */
 690
 691 void WMSetViewDragSourceProcs(WMView *view, WMDragSourceProcs *procs);
 692
 693 void WMDragImageFromView(WMView *view, WMPixmap *image, char *dataTypes[],
 694                          WMPoint atLocation, WMSize mouseOffset, XEvent *event,
 695                          Bool slideBack);
 696
 697 void WMRegisterViewForDraggedTypes(WMView *view, char *acceptedTypes[]);
 698
 699 void WMUnregisterViewDraggedTypes(WMView *view);
 700
 701 void WMSetViewDragDestinationProcs(WMView *view, WMDragDestinationProcs *procs);
 702
 703
 704 WMPoint WMGetDraggingInfoImageLocation(WMDraggingInfo *info);
 705
 706 /* ....................................................................... */
 707
 708 WMFont *WMCreateFontSet(WMScreen *scrPtr, char *fontName);
 709
 710 WMFont *WMCreateNormalFont(WMScreen *scrPtr, char *fontName);
 711
 712 WMFont *WMCreateFont(WMScreen *scrPtr, char *fontName);
 713
 714 WMFont *WMRetainFont(WMFont *font);
 715
 716 void WMReleaseFont(WMFont *font);
 717
 718 unsigned int WMFontHeight(WMFont *font);
 719
 720 /*
 721 WMFont *WMUserFontOfSize(WMScreen *scrPtr, int size);
 722
 723 WMFont *WMUserFixedPitchFontOfSize(WMScreen *scrPtr, int size);
 724 */
 725
 726
 727 void WMSetWidgetDefaultFont(WMScreen *scr, WMFont *font);
 728
 729 void WMSetWidgetDefaultBoldFont(WMScreen *scr, WMFont *font);
 730
 731 WMFont *WMSystemFontOfSize(WMScreen *scrPtr, int size);
 732
 733 WMFont *WMBoldSystemFontOfSize(WMScreen *scrPtr, int size);
 734
 735 XFontSet WMGetFontFontSet(WMFont *font);
 736
 737 WMFont *WMNormalizeFont(WMScreen *scr, WMFont *font);
 738
 739 WMFont *WMStrengthenFont(WMScreen *scr, WMFont *font);
 740
 741 WMFont *WMUnstrengthenFont(WMScreen *scr, WMFont *font);
 742
 743 WMFont *WMEmphasizeFont(WMScreen *scr, WMFont *font);
 744
 745 WMFont *WMUnemphasizeFont(WMScreen *scr, WMFont *font);
 746
 747 WMFont *WMGetFontOfSize(WMScreen *scr, WMFont *font, int size);
 748
 749 /* ....................................................................... */
 750
 751 WMPixmap *WMRetainPixmap(WMPixmap *pixmap);
 752
 753 void WMReleasePixmap(WMPixmap *pixmap);
 754
 755 WMPixmap *WMCreatePixmap(WMScreen *scrPtr, int width, int height, int depth,
 756                          Bool masked);
 757
 758 WMPixmap *WMCreatePixmapFromXPixmaps(WMScreen *scrPtr, Pixmap pixmap,
 759                                      Pixmap mask, int width, int height,
 760                                      int depth);
 761
 762 WMPixmap *WMCreatePixmapFromRImage(WMScreen *scrPtr, RImage *image,
 763                                    int threshold);
 764
 765 WMPixmap *WMCreatePixmapFromXPMData(WMScreen *scrPtr, char **data);
 766
 767 WMSize WMGetPixmapSize(WMPixmap *pixmap);
 768
 769 WMPixmap *WMCreatePixmapFromFile(WMScreen *scrPtr, char *fileName);
 770
 771 WMPixmap *WMCreateBlendedPixmapFromFile(WMScreen *scrPtr, char *fileName,
 772                                         RColor *color);
 773
 774 void WMDrawPixmap(WMPixmap *pixmap, Drawable d, int x, int y);
 775
 776 Pixmap WMGetPixmapXID(WMPixmap *pixmap);
 777
 778 Pixmap WMGetPixmapMaskXID(WMPixmap *pixmap);
 779
 780 WMPixmap *WMGetSystemPixmap(WMScreen *scr, int image);
 781
 782 /* ....................................................................... */
 783
 784
 785 WMColor *WMDarkGrayColor(WMScreen *scr);
 786
 787 WMColor *WMGrayColor(WMScreen *scr);
 788
 789 WMColor *WMBlackColor(WMScreen *scr);
 790
 791 WMColor *WMWhiteColor(WMScreen *scr);
 792
 793 void WMSetColorInGC(WMColor *color, GC gc);
 794
 795 GC WMColorGC(WMColor *color);
 796
 797 WMPixel WMColorPixel(WMColor *color);
 798
 799 void WMPaintColorSwatch(WMColor *color, Drawable d, int x, int y,
 800                         unsigned int width, unsigned int height);
 801
 802 void WMReleaseColor(WMColor *color);
 803
 804 WMColor *WMRetainColor(WMColor *color);
 805
 806 WMColor *WMCreateRGBColor(WMScreen *scr, unsigned short red,
 807                           unsigned short green, unsigned short blue,
 808                           Bool exact);
 809
 810 WMColor *WMCreateNamedColor(WMScreen *scr, char *name, Bool exact);
 811
 812 unsigned short WMRedComponentOfColor(WMColor *color);
 813
 814 unsigned short WMGreenComponentOfColor(WMColor *color);
 815
 816 unsigned short WMBlueComponentOfColor(WMColor *color);
 817
 818 char *WMGetColorRGBDescription(WMColor *color);
 819
 820 /* ....................................................................... */
 821
 822
 823 void WMDrawString(WMScreen *scr, Drawable d, GC gc, WMFont *font, int x,
 824                   int y, char *text, int length);
 825
 826 void WMDrawImageString(WMScreen *scr, Drawable d, GC gc, WMFont *font, int x,
 827                        int y, char *text, int length);
 828
 829 int WMWidthOfString(WMFont *font, char *text, int length);
 830
 831
 832
 833 /* ....................................................................... */
 834
 835 WMScreen *WMWidgetScreen(WMWidget *w);
 836
 837 unsigned int WMScreenWidth(WMScreen *scr);
 838
 839 unsigned int WMScreenHeight(WMScreen *scr);
 840
 841 void WMUnmapWidget(WMWidget *w);
 842
 843 void WMMapWidget(WMWidget *w);
 844
 845 Bool WMWidgetIsMapped(WMWidget *w);
 846
 847 void WMRaiseWidget(WMWidget *w);
 848
 849 void WMLowerWidget(WMWidget *w);
 850
 851 void WMMoveWidget(WMWidget *w, int x, int y);
 852
 853 void WMResizeWidget(WMWidget *w, unsigned int width, unsigned int height);
 854
 855 void WMSetWidgetBackgroundColor(WMWidget *w, WMColor *color);
 856
 857 void WMMapSubwidgets(WMWidget *w);
 858
 859 void WMUnmapSubwidgets(WMWidget *w);
 860
 861 void WMRealizeWidget(WMWidget *w);
 862
 863 void WMDestroyWidget(WMWidget *widget);
 864
 865 void WMHangData(WMWidget *widget, void *data);
 866
 867 void *WMGetHangedData(WMWidget *widget);
 868
 869 unsigned int WMWidgetWidth(WMWidget *w);
 870
 871 unsigned int WMWidgetHeight(WMWidget *w);
 872
 873 Window WMWidgetXID(WMWidget *w);
 874
 875 Window WMViewXID(WMView *view);
 876
 877 void WMRedisplayWidget(WMWidget *w);
 878
 879 void WMSetViewNotifySizeChanges(WMView *view, Bool flag);
 880
 881 void WMSetViewExpandsToParent(WMView *view, int topOffs, int leftOffs,
 882                               int rightOffs, int bottomOffs);
 883
 884 WMSize WMGetViewSize(WMView *view);
 885
 886 WMPoint WMGetViewPosition(WMView *view);
 887
 888 WMPoint WMGetViewScreenPosition(WMView *view);
 889
 890 WMWidget *WMWidgetOfView(WMView *view);
 891
 892 void WMSetViewNextResponder(WMView *view, WMView *responder);
 893
 894 void WMRelayToNextResponder(WMView *view, XEvent *event);
 895
 896 /* notifications */
 897 extern char *WMViewSizeDidChangeNotification;
 898
 899 extern char *WMViewRealizedNotification;
 900
 901 extern char *WMFontPanelDidChangeNotification;
 902
 903
 904 /* ....................................................................... */
 905
 906 void WMSetBalloonTextForView(char *text, WMView *view);
 907
 908 void WMSetBalloonTextAlignment(WMScreen *scr, WMAlignment alignment);
 909
 910 void WMSetBalloonFont(WMScreen *scr, WMFont *font);
 911
 912 void WMSetBalloonTextColor(WMScreen *scr, WMColor *color);
 913
 914 void WMSetBalloonDelay(WMScreen *scr, int delay);
 915
 916 void WMSetBalloonEnabled(WMScreen *scr, Bool flag);
 917
 918
 919 /* ....................................................................... */
 920
 921 WMWindow *WMCreateWindow(WMScreen *screen, char *name);
 922
 923 WMWindow *WMCreateWindowWithStyle(WMScreen *screen, char *name, int style);
 924
 925 WMWindow *WMCreatePanelWithStyleForWindow(WMWindow *owner, char *name,
 926                                           int style);
 927
 928 WMWindow *WMCreatePanelForWindow(WMWindow *owner, char *name);
 929
 930 void WMChangePanelOwner(WMWindow *win, WMWindow *newOwner);
 931
 932 void WMSetWindowTitle(WMWindow *wPtr, char *title);
 933
 934 void WMSetWindowMiniwindowTitle(WMWindow *win, char *title);
 935
 936 void WMSetWindowMiniwindowImage(WMWindow *win, WMPixmap *pixmap);
 937
 938 void WMSetWindowCloseAction(WMWindow *win, WMAction *action, void *clientData);
 939
 940 void WMSetWindowInitialPosition(WMWindow *win, int x, int y);
 941
 942 void WMSetWindowUserPosition(WMWindow *win, int x, int y);
 943
 944 void WMSetWindowAspectRatio(WMWindow *win, int minX, int minY,
 945                             int maxX, int maxY);
 946
 947 void WMSetWindowMaxSize(WMWindow *win, unsigned width, unsigned height);
 948
 949 void WMSetWindowMinSize(WMWindow *win, unsigned width, unsigned height);
 950
 951 void WMSetWindowBaseSize(WMWindow *win, unsigned width, unsigned height);
 952
 953 void WMSetWindowResizeIncrements(WMWindow *win, unsigned wIncr, unsigned hIncr);
 954
 955 void WMSetWindowLevel(WMWindow *win, int level);
 956
 957 void WMSetWindowDocumentEdited(WMWindow *win, Bool flag);
 958
 959 void WMCloseWindow(WMWindow *win);
 960
 961 /* ....................................................................... */
 962
 963 void WMSetButtonAction(WMButton *bPtr, WMAction *action, void *clientData);
 964
 965 #define WMCreateCommandButton(parent) \
 966         WMCreateCustomButton((parent), WBBSpringLoadedMask\
 967                                         |WBBPushInMask\
 968                                         |WBBPushLightMask\
 969                                         |WBBPushChangeMask)
 970
 971 #define WMCreateRadioButton(parent) \
 972         WMCreateButton((parent), WBTRadio)
 973
 974 #define WMCreateSwitchButton(parent) \
 975         WMCreateButton((parent), WBTSwitch)
 976
 977 WMButton *WMCreateButton(WMWidget *parent, WMButtonType type);
 978
 979 WMButton *WMCreateCustomButton(WMWidget *parent, int behaviourMask);
 980
 981 void WMSetButtonImageDefault(WMButton *bPtr);
 982
 983 void WMSetButtonImage(WMButton *bPtr, WMPixmap *image);
 984
 985 void WMSetButtonAltImage(WMButton *bPtr, WMPixmap *image);
 986
 987 void WMSetButtonImagePosition(WMButton *bPtr, WMImagePosition position);
 988
 989 void WMSetButtonFont(WMButton *bPtr, WMFont *font);
 990
 991 void WMSetButtonTextAlignment(WMButton *bPtr, WMAlignment alignment);
 992
 993 void WMSetButtonText(WMButton *bPtr, char *text);
 994
 995 void WMSetButtonAltText(WMButton *bPtr, char *text);
 996
 997 void WMSetButtonTextColor(WMButton *bPtr, WMColor *color);
 998
 999 void WMSetButtonAltTextColor(WMButton *bPtr, WMColor *color);
1000
1001 void WMSetButtonDisabledTextColor(WMButton *bPtr, WMColor *color);
1002
1003 void WMSetButtonSelected(WMButton *bPtr, int isSelected);
1004
1005 int WMGetButtonSelected(WMButton *bPtr);
1006
1007 void WMSetButtonBordered(WMButton *bPtr, int isBordered);
1008
1009 void WMSetButtonEnabled(WMButton *bPtr, Bool flag);
1010
1011 void WMSetButtonImageDimsWhenDisabled(WMButton *bPtr, Bool flag);
1012
1013 void WMSetButtonTag(WMButton *bPtr, int tag);
1014
1015 void WMGroupButtons(WMButton *bPtr, WMButton *newMember);
1016
1017 void WMPerformButtonClick(WMButton *bPtr);
1018
1019 void WMSetButtonContinuous(WMButton *bPtr, Bool flag);
1020
1021 void WMSetButtonPeriodicDelay(WMButton *bPtr, float delay, float interval);
1022
1023 /* ....................................................................... */
1024
1025 WMLabel *WMCreateLabel(WMWidget *parent);
1026
1027 void WMSetLabelWraps(WMLabel *lPtr, Bool flag);
1028
1029 void WMSetLabelImage(WMLabel *lPtr, WMPixmap *image);
1030
1031 WMPixmap *WMGetLabelImage(WMLabel *lPtr);
1032
1033 char *WMGetLabelText(WMLabel *lPtr);
1034
1035 void WMSetLabelImagePosition(WMLabel *lPtr, WMImagePosition position);
1036
1037 void WMSetLabelTextAlignment(WMLabel *lPtr, WMAlignment alignment);
1038
1039 void WMSetLabelRelief(WMLabel *lPtr, WMReliefType relief);
1040
1041 void WMSetLabelText(WMLabel *lPtr, char *text);
1042
1043 void WMSetLabelFont(WMLabel *lPtr, WMFont *font);
1044
1045 void WMSetLabelTextColor(WMLabel *lPtr, WMColor *color);
1046
1047 /* ....................................................................... */
1048
1049 WMFrame *WMCreateFrame(WMWidget *parent);
1050
1051 void WMSetFrameTitlePosition(WMFrame *fPtr, WMTitlePosition position);
1052
1053 void WMSetFrameRelief(WMFrame *fPtr, WMReliefType relief);
1054
1055 void WMSetFrameTitle(WMFrame *fPtr, char *title);
1056
1057 /* ....................................................................... */
1058
1059 WMTextField *WMCreateTextField(WMWidget *parent);
1060
1061 void WMInsertTextFieldText(WMTextField *tPtr, char *text, int position);
1062
1063 void WMDeleteTextFieldRange(WMTextField *tPtr, WMRange range);
1064
1065 /* you can free the returned string */
1066 char *WMGetTextFieldText(WMTextField *tPtr);
1067
1068 void WMSetTextFieldText(WMTextField *tPtr, char *text);
1069
1070 void WMSetTextFieldAlignment(WMTextField *tPtr, WMAlignment alignment);
1071
1072 void WMSetTextFieldFont(WMTextField *tPtr, WMFont *font);
1073
1074 WMFont *WMGetTextFieldFont(WMTextField *tPtr);
1075
1076 void WMSetTextFieldBordered(WMTextField *tPtr, Bool bordered);
1077
1078 void WMSetTextFieldBeveled(WMTextField *tPtr, Bool flag);
1079
1080 Bool WMGetTextFieldEditable(WMTextField *tPtr);
1081
1082 void WMSetTextFieldEditable(WMTextField *tPtr, Bool flag);
1083
1084 void WMSetTextFieldSecure(WMTextField *tPtr, Bool flag);
1085
1086 void WMSelectTextFieldRange(WMTextField *tPtr, WMRange range);
1087
1088 void WMSetTextFieldCursorPosition(WMTextField *tPtr, unsigned int position);
1089
1090 void WMSetTextFieldNextTextField(WMTextField *tPtr, WMTextField *next);
1091
1092 void WMSetTextFieldPrevTextField(WMTextField *tPtr, WMTextField *prev);
1093
1094 void WMSetTextFieldDelegate(WMTextField *tPtr, WMTextFieldDelegate *delegate);
1095
1096
1097 extern char *WMTextDidChangeNotification;
1098 extern char *WMTextDidBeginEditingNotification;
1099 extern char *WMTextDidEndEditingNotification;
1100
1101 /* ....................................................................... */
1102
1103 WMScroller *WMCreateScroller(WMWidget *parent);
1104
1105 void WMSetScrollerParameters(WMScroller *sPtr, float floatValue,
1106                              float knobProportion);
1107
1108 float WMGetScrollerKnobProportion(WMScroller *sPtr);
1109
1110 float WMGetScrollerValue(WMScroller *sPtr);
1111
1112 WMScrollerPart WMGetScrollerHitPart(WMScroller *sPtr);
1113
1114 void WMSetScrollerAction(WMScroller *sPtr, WMAction *action, void *clientData);
1115
1116 void WMSetScrollerArrowsPosition(WMScroller *sPtr,
1117                                  WMScrollArrowPosition position);
1118
1119 extern char *WMScrollerDidScrollNotification;
1120
1121 /* ....................................................................... */
1122
1123 WMList *WMCreateList(WMWidget *parent);
1124
1125 void WMSetListAllowMultipleSelection(WMList *lPtr, Bool flag);
1126
1127 void WMSetListAllowEmptySelection(WMList *lPtr, Bool flag);
1128
1129 #define WMAddListItem(lPtr, text) WMInsertListItem((lPtr), -1, (text))
1130
1131 WMListItem *WMInsertListItem(WMList *lPtr, int row, char *text);
1132
1133 void WMSortListItems(WMList *lPtr);
1134
1135 void WMSortListItemsWithComparer(WMList *lPtr, WMCompareDataProc *func);
1136
1137 int WMFindRowOfListItemWithTitle(WMList *lPtr, char *title);
1138
1139 WMListItem *WMGetListItem(WMList *lPtr, int row);
1140
1141 WMArray *WMGetListItems(WMList *lPtr);
1142
1143 void WMRemoveListItem(WMList *lPtr, int row);
1144
1145 void WMSelectListItem(WMList *lPtr, int row);
1146
1147 void WMUnselectListItem(WMList *lPtr, int row);
1148
1149 /* This will select all items in range, and deselect all the others */
1150 void WMSetListSelectionToRange(WMList *lPtr, WMRange range);
1151
1152 /* This will select all items in range, leaving the others as they are */
1153 void WMSelectListItemsInRange(WMList *lPtr, WMRange range);
1154
1155 void WMSelectAllListItems(WMList *lPtr);
1156
1157 void WMUnselectAllListItems(WMList *lPtr);
1158
1159 void WMSetListUserDrawProc(WMList *lPtr, WMListDrawProc *proc);
1160
1161 void WMSetListUserDrawItemHeight(WMList *lPtr, unsigned short height);
1162
1163 int WMGetListItemHeight(WMList *lPtr);
1164
1165 /* don't free the returned data */
1166 WMArray* WMGetListSelectedItems(WMList *lPtr);
1167
1168 /*
1169  * For the following 2 functions, in case WMList allows multiple selection,
1170  * the first item in the list of selected items, respective its row number,
1171  * will be returned.
1172  */
1173
1174 /* don't free the returned data */
1175 WMListItem* WMGetListSelectedItem(WMList *lPtr);
1176
1177 int WMGetListSelectedItemRow(WMList *lPtr);
1178
1179 void WMSetListAction(WMList *lPtr, WMAction *action, void *clientData);
1180
1181 void WMSetListDoubleAction(WMList *lPtr, WMAction *action, void *clientData);
1182
1183 void WMClearList(WMList *lPtr);
1184
1185 int WMGetListNumberOfRows(WMList *lPtr);
1186
1187 void WMSetListPosition(WMList *lPtr, int row);
1188
1189 void WMSetListBottomPosition(WMList *lPtr, int row);
1190
1191 int WMGetListPosition(WMList *lPtr);
1192
1193 Bool WMListAllowsMultipleSelection(WMList *lPtr);
1194
1195 Bool WMListAllowsEmptySelection(WMList *lPtr);
1196
1197
1198 extern char *WMListDidScrollNotification;
1199 extern char *WMListSelectionDidChangeNotification;
1200
1201 /* ....................................................................... */
1202
1203 WMBrowser *WMCreateBrowser(WMWidget *parent);
1204
1205 void WMSetBrowserAllowMultipleSelection(WMBrowser *bPtr, Bool flag);
1206
1207 void WMSetBrowserAllowEmptySelection(WMBrowser *bPtr, Bool flag);
1208
1209 void WMSetBrowserPathSeparator(WMBrowser *bPtr, char *separator);
1210
1211 void WMSetBrowserTitled(WMBrowser *bPtr, Bool flag);
1212
1213 void WMLoadBrowserColumnZero(WMBrowser *bPtr);
1214
1215 int WMAddBrowserColumn(WMBrowser *bPtr);
1216
1217 void WMRemoveBrowserItem(WMBrowser *bPtr, int column, int row);
1218
1219 void WMSetBrowserMaxVisibleColumns(WMBrowser *bPtr, int columns);
1220
1221 void WMSetBrowserColumnTitle(WMBrowser *bPtr, int column, char *title);
1222
1223 WMListItem *WMInsertBrowserItem(WMBrowser *bPtr, int column, int row, char *text, Bool isBranch);
1224
1225 void WMSortBrowserColumn(WMBrowser *bPtr, int column);
1226
1227 void WMSortBrowserColumnWithComparer(WMBrowser *bPtr, int column,
1228                                      WMCompareDataProc *func);
1229
1230 /* Don't free the returned string. */
1231 char* WMSetBrowserPath(WMBrowser *bPtr, char *path);
1232
1233 /* free the returned string */
1234 char *WMGetBrowserPath(WMBrowser *bPtr);
1235
1236 /* free the returned string */
1237 char *WMGetBrowserPathToColumn(WMBrowser *bPtr, int column);
1238
1239 /* free the returned array */
1240 WMArray* WMGetBrowserPaths(WMBrowser *bPtr);
1241
1242 void WMSetBrowserAction(WMBrowser *bPtr, WMAction *action, void *clientData);
1243
1244 void WMSetBrowserDoubleAction(WMBrowser *bPtr, WMAction *action,
1245                               void *clientData);
1246
1247 WMListItem *WMGetBrowserSelectedItemInColumn(WMBrowser *bPtr, int column);
1248
1249 int WMGetBrowserFirstVisibleColumn(WMBrowser *bPtr);
1250
1251 int WMGetBrowserSelectedColumn(WMBrowser *bPtr);
1252
1253 int WMGetBrowserSelectedRowInColumn(WMBrowser *bPtr, int column);
1254
1255 int WMGetBrowserNumberOfColumns(WMBrowser *bPtr);
1256
1257 int WMGetBrowserMaxVisibleColumns(WMBrowser *bPtr);
1258
1259 WMList *WMGetBrowserListInColumn(WMBrowser *bPtr, int column);
1260
1261 void WMSetBrowserDelegate(WMBrowser *bPtr, WMBrowserDelegate *delegate);
1262
1263 Bool WMBrowserAllowsMultipleSelection(WMBrowser *bPtr);
1264
1265 Bool WMBrowserAllowsEmptySelection(WMBrowser *bPtr);
1266
1267 void WMSetBrowserHasScroller(WMBrowser *bPtr, int hasScroller);
1268
1269 /* ....................................................................... */
1270
1271
1272 Bool WMMenuItemIsSeparator(WMMenuItem *item);
1273
1274 WMMenuItem *WMCreateMenuItem(void);
1275
1276 void WMDestroyMenuItem(WMMenuItem *item);
1277
1278 Bool WMGetMenuItemEnabled(WMMenuItem *item);
1279
1280 void WMSetMenuItemEnabled(WMMenuItem *item, Bool flag);
1281
1282 char *WMGetMenuItemShortcut(WMMenuItem *item);
1283
1284 unsigned WMGetMenuItemShortcutModifierMask(WMMenuItem *item);
1285
1286 void WMSetMenuItemShortcut(WMMenuItem *item, char *shortcut);
1287
1288 void WMSetMenuItemShortcutModifierMask(WMMenuItem *item, unsigned mask);
1289
1290 void *WMGetMenuItemRepresentedObject(WMMenuItem *item);
1291
1292 void WMSetMenuItemRepresentedObject(WMMenuItem *item, void *object);
1293
1294 void WMSetMenuItemAction(WMMenuItem *item, WMAction *action, void *data);
1295
1296 WMAction *WMGetMenuItemAction(WMMenuItem *item);
1297
1298 void *WMGetMenuItemData(WMMenuItem *item);
1299
1300 void WMSetMenuItemTitle(WMMenuItem *item, char *title);
1301
1302 char *WMGetMenuItemTitle(WMMenuItem *item);
1303
1304 void WMSetMenuItemState(WMMenuItem *item, int state);
1305
1306 int WMGetMenuItemState(WMMenuItem *item);
1307
1308 void WMSetMenuItemPixmap(WMMenuItem *item, WMPixmap *pixmap);
1309
1310 WMPixmap *WMGetMenuItemPixmap(WMMenuItem *item);
1311
1312 void WMSetMenuItemOnStatePixmap(WMMenuItem *item, WMPixmap *pixmap);
1313
1314 WMPixmap *WMGetMenuItemOnStatePixmap(WMMenuItem *item);
1315
1316 void WMSetMenuItemOffStatePixmap(WMMenuItem *item, WMPixmap *pixmap);
1317
1318 WMPixmap *WMGetMenuItemOffStatePixmap(WMMenuItem *item);
1319
1320 void WMSetMenuItemMixedStatePixmap(WMMenuItem *item, WMPixmap *pixmap);
1321
1322 WMPixmap *WMGetMenuItemMixedStatePixmap(WMMenuItem *item);
1323
1324 /*void WMSetMenuItemSubmenu(WMMenuItem *item, WMMenu *submenu);
1325
1326
1327 WMMenu *WMGetMenuItemSubmenu(WMMenuItem *item);
1328
1329 Bool WMGetMenuItemHasSubmenu(WMMenuItem *item);
1330  */
1331
1332 /* ....................................................................... */
1333
1334 WMPopUpButton *WMCreatePopUpButton(WMWidget *parent);
1335
1336 void WMSetPopUpButtonAction(WMPopUpButton *sPtr, WMAction *action,
1337                             void *clientData);
1338
1339 void WMSetPopUpButtonPullsDown(WMPopUpButton *bPtr, Bool flag);
1340
1341 WMMenuItem *WMAddPopUpButtonItem(WMPopUpButton *bPtr, char *title);
1342
1343 WMMenuItem *WMInsertPopUpButtonItem(WMPopUpButton *bPtr, int index,
1344                                     char *title);
1345
1346 void WMRemovePopUpButtonItem(WMPopUpButton *bPtr, int index);
1347
1348 void WMSetPopUpButtonItemEnabled(WMPopUpButton *bPtr, int index, Bool flag);
1349
1350 Bool WMGetPopUpButtonItemEnabled(WMPopUpButton *bPtr, int index);
1351
1352 void WMSetPopUpButtonSelectedItem(WMPopUpButton *bPtr, int index);
1353
1354 int WMGetPopUpButtonSelectedItem(WMPopUpButton *bPtr);
1355
1356 void WMSetPopUpButtonText(WMPopUpButton *bPtr, char *text);
1357
1358 /* don't free the returned data */
1359 char *WMGetPopUpButtonItem(WMPopUpButton *bPtr, int index);
1360
1361 WMMenuItem *WMGetPopUpButtonMenuItem(WMPopUpButton *bPtr, int index);
1362
1363
1364 int WMGetPopUpButtonNumberOfItems(WMPopUpButton *bPtr);
1365
1366 void WMSetPopUpButtonEnabled(WMPopUpButton *bPtr, Bool flag);
1367
1368 Bool WMGetPopUpButtonEnabled(WMPopUpButton *bPtr);
1369
1370 /* ....................................................................... */
1371
1372 WMProgressIndicator *WMCreateProgressIndicator(WMWidget *parent);
1373
1374 void WMSetProgressIndicatorMinValue(WMProgressIndicator *progressindicator, int value);
1375
1376 void WMSetProgressIndicatorMaxValue(WMProgressIndicator *progressindicator, int value);
1377
1378 void WMSetProgressIndicatorValue(WMProgressIndicator *progressindicator, int value);
1379
1380 int WMGetProgressIndicatorMinValue(WMProgressIndicator *progressindicator);
1381
1382 int WMGetProgressIndicatorMaxValue(WMProgressIndicator *progressindicator);
1383
1384 int WMGetProgressIndicatorValue(WMProgressIndicator *progressindicator);
1385
1386
1387 /* ....................................................................... */
1388
1389 WMColorPanel *WMGetColorPanel(WMScreen *scrPtr);
1390
1391 void WMFreeColorPanel(WMColorPanel *panel);
1392
1393 void WMShowColorPanel(WMColorPanel *panel);
1394
1395 void WMCloseColorPanel(WMColorPanel *panel);
1396
1397 void WMSetColorPanelColor(WMColorPanel *panel, WMColor *color);
1398
1399 WMColor *WMGetColorPanelColor(WMColorPanel *panel);
1400
1401 void WMSetColorPanelPickerMode(WMColorPanel *panel, WMColorPanelMode mode);
1402
1403 void WMSetColorPanelAction(WMColorPanel *panel, WMAction2 *action, void *data);
1404
1405 extern char *WMColorPanelColorChangedNotification;
1406
1407 /* ....................................................................... */
1408
1409 WMColorWell *WMCreateColorWell(WMWidget *parent);
1410
1411 void WMSetColorWellColor(WMColorWell *cPtr, WMColor *color);
1412
1413 WMColor *WMGetColorWellColor(WMColorWell *cPtr);
1414
1415 void WSetColorWellBordered(WMColorWell *cPtr, Bool flag);
1416
1417
1418 extern char *WMColorWellDidChangeNotification;
1419
1420
1421 /* ...................................................................... */
1422
1423 WMScrollView *WMCreateScrollView(WMWidget *parent);
1424
1425 void WMResizeScrollViewContent(WMScrollView *sPtr, unsigned int width,
1426                                unsigned int height);
1427
1428 void WMSetScrollViewHasHorizontalScroller(WMScrollView *sPtr, Bool flag);
1429
1430 void WMSetScrollViewHasVerticalScroller(WMScrollView *sPtr, Bool flag);
1431
1432 void WMSetScrollViewContentView(WMScrollView *sPtr, WMView *view);
1433
1434 void WMSetScrollViewRelief(WMScrollView *sPtr, WMReliefType type);
1435
1436 void WMSetScrollViewContentView(WMScrollView *sPtr, WMView *view);
1437
1438 WMRect WMGetScrollViewVisibleRect(WMScrollView *sPtr);
1439
1440 WMScroller *WMGetScrollViewHorizontalScroller(WMScrollView *sPtr);
1441
1442 WMScroller *WMGetScrollViewVerticalScroller(WMScrollView *sPtr);
1443
1444 void WMSetScrollViewLineScroll(WMScrollView *sPtr, int amount);
1445
1446 void WMSetScrollViewPageScroll(WMScrollView *sPtr, int amount);
1447
1448 /* ....................................................................... */
1449
1450 WMSlider *WMCreateSlider(WMWidget *parent);
1451
1452 int WMGetSliderMinValue(WMSlider *slider);
1453
1454 int WMGetSliderMaxValue(WMSlider *slider);
1455
1456 int WMGetSliderValue(WMSlider *slider);
1457
1458 void WMSetSliderMinValue(WMSlider *slider, int value);
1459
1460 void WMSetSliderMaxValue(WMSlider *slider, int value);
1461
1462 void WMSetSliderValue(WMSlider *slider, int value);
1463
1464 void WMSetSliderContinuous(WMSlider *slider, Bool flag);
1465
1466 void WMSetSliderAction(WMSlider *slider, WMAction *action, void *data);
1467
1468 void WMSetSliderKnobThickness(WMSlider *sPtr, int thickness);
1469
1470 void WMSetSliderImage(WMSlider *sPtr, WMPixmap *pixmap);
1471
1472 /* ....................................................................... */
1473
1474
1475 WMSplitView *WMCreateSplitView(WMWidget *parent);
1476 Bool WMGetSplitViewVertical(WMSplitView *sPtr);
1477 void WMSetSplitViewVertical(WMSplitView *sPtr, Bool flag);
1478
1479 int WMGetSplitViewSubviewsCount(WMSplitView *sPtr); /* ??? remove ??? */
1480
1481 WMView *WMGetSplitViewSubviewAt(WMSplitView *sPtr, int index);
1482
1483 /* remove the first subview == view */
1484 void WMRemoveSplitViewSubview(WMSplitView *sPtr, WMView *view);
1485
1486 void WMRemoveSplitViewSubviewAt(WMSplitView *sPtr, int index);
1487
1488
1489 void WMAddSplitViewSubview(WMSplitView *sPtr, WMView *subview);
1490
1491 void WMAdjustSplitViewSubviews(WMSplitView *sPtr);
1492
1493 void WMSetSplitViewConstrainProc(WMSplitView *sPtr,
1494                                  WMSplitViewConstrainProc *proc);
1495
1496 /*
1497 void WMSetSplitViewResizeSubviewsProc(WMSplitView *sPtr,
1498                                       WMSplitViewResizeSubviewsProc *proc);
1499 */
1500
1501 int WMGetSplitViewDividerThickness(WMSplitView *sPtr);
1502
1503 /* ...................................................................... */
1504
1505 WMRuler *WMCreateRuler (WMWidget *parent);
1506
1507 WMRulerMargins *WMGetRulerMargins(WMRuler *rPtr);
1508
1509 void WMSetRulerMargins(WMRuler *rPtr, WMRulerMargins margins);
1510
1511 Bool WMIsMarginEqualToMargin(WMRulerMargins *aMargin,
1512     WMRulerMargins *anotherMargin);
1513
1514 int WMGetGrabbedRulerMargin(WMRuler *rPtr);
1515
1516 int WMGetReleasedRulerMargin(WMRuler *rPtr);
1517
1518 int WMGetRulerOffset(WMRuler *rPtr);
1519
1520 void WMSetRulerOffset(WMRuler *rPtr, int pixels);
1521
1522 void WMSetRulerMoveAction(WMRuler *rPtr, WMAction *action, void *clientData);
1523
1524 void WMSetRulerReleaseAction(WMRuler *rPtr, WMAction *action, void *clientData);
1525
1526 /* ....................................................................... */
1527
1528
1529 #define WMCreateText(parent) WMCreateTextForDocumentType \
1530     ((parent), (NULL), (NULL))
1531
1532 WMText *WMCreateTextForDocumentType(WMWidget *parent,
1533         WMAction *parser, WMAction *writer);
1534
1535 void WMSetTextDelegate(WMText *tPtr, WMTextDelegate *delegate);
1536
1537 void WMFreezeText(WMText *tPtr);
1538
1539 #define WMRefreshText(tPtr) WMThawText((tPtr))
1540
1541 void WMThawText(WMText *tPtr);
1542
1543 int WMScrollText(WMText *tPtr, int amount);
1544
1545 int WMPageText(WMText *tPtr, Bool direction);
1546
1547 void WMSetTextHasHorizontalScroller(WMText *tPtr, Bool shouldhave);
1548
1549 void WMSetTextHasVerticalScroller(WMText *tPtr, Bool shouldhave);
1550
1551 void WMSetTextHasRuler(WMText *tPtr, Bool shouldhave);
1552
1553 void WMShowTextRuler(WMText *tPtr, Bool show);
1554
1555 int WMGetTextRulerShown(WMText *tPtr);
1556
1557 void WMSetTextEditable(WMText *tPtr, Bool editable);
1558
1559 int WMGetTextEditable(WMText *tPtr);
1560
1561 void WMSetTextUsesMonoFont(WMText *tPtr, Bool mono);
1562
1563 int WMGetTextUsesMonoFont(WMText *tPtr);
1564
1565 void WMSetTextIndentNewLines(WMText *tPtr, Bool indent);
1566
1567 void WMSetTextIgnoresNewline(WMText *tPtr, Bool ignore);
1568
1569 int WMGetTextIgnoresNewline(WMText *tPtr);
1570
1571 void WMSetTextDefaultFont(WMText *tPtr, WMFont *font);
1572
1573 WMFont * WMGetTextDefaultFont(WMText *tPtr);
1574
1575 void WMSetTextDefaultColor(WMText *tPtr, WMColor *color);
1576
1577 WMColor * WMGetTextDefaultColor(WMText *tPtr);
1578
1579 void WMSetTextRelief(WMText *tPtr, WMReliefType relief);
1580
1581 void WMSetTextForegroundColor(WMText *tPtr, WMColor *color);
1582
1583 void WMSetTextBackgroundColor(WMText *tPtr, WMColor *color);
1584
1585 void WMSetTextBackgroundPixmap(WMText *tPtr, WMPixmap *pixmap);
1586
1587 void WMPrependTextStream(WMText *tPtr, char *text);
1588
1589 void WMAppendTextStream(WMText *tPtr, char *text);
1590
1591 /* free the text */
1592 char * WMGetTextStream(WMText *tPtr);
1593
1594 /* free the text */
1595 char * WMGetTextSelectedStream(WMText *tPtr);
1596
1597 /* destroy the array */
1598 WMArray * WMGetTextObjects(WMText *tPtr);
1599
1600 /* destroy the array */
1601 WMArray* WMGetTextSelectedObjects(WMText *tPtr);
1602
1603 void WMSetTextSelectionColor(WMText *tPtr, WMColor *color);
1604
1605 WMColor *WMGetTextSelectionColor(WMText *tPtr);
1606
1607 void WMSetTextSelectionFont(WMText *tPtr, WMFont *font);
1608
1609 WMFont *WMGetTextSelectionFont(WMText *tPtr);
1610
1611 void WMSetTextSelectionUnderlined(WMText *tPtr, int underlined);
1612
1613 int WMGetTextSelectionUnderlined(WMText *tPtr);
1614
1615 void WMSetTextAlignment(WMText *tPtr, WMAlignment alignment);
1616
1617 Bool WMFindInTextStream(WMText *tPtr, char *needle, Bool direction,
1618     Bool caseSensitive);
1619
1620 Bool WMReplaceTextSelection(WMText *tPtr, char *replacement);
1621
1622
1623 /* parser related stuff... use only if implementing a new parser */
1624
1625 void *WMCreateTextBlockWithObject(WMText *tPtr, WMWidget *w, char *description,
1626     WMColor *color, unsigned short first, unsigned short extraInfo);
1627
1628 void *WMCreateTextBlockWithPixmap(WMText *tPtr, WMPixmap *p, char *description,
1629         WMColor *color, unsigned short first, unsigned short extraInfo);
1630
1631 void *WMCreateTextBlockWithText(WMText *tPtr, char *text, WMFont *font,
1632     WMColor *color, unsigned short first, unsigned short length);
1633
1634 void WMSetTextBlockProperties(WMText *tPtr, void *vtb, unsigned int first,
1635     unsigned int kanji, unsigned int underlined, int script,
1636         WMRulerMargins *margins);
1637
1638 /* do NOT free the margins */
1639 void WMGetTextBlockProperties(WMText *tPtr, void *vtb, unsigned int *first,
1640     unsigned int *kanji, unsigned int *underlined, int *script,
1641         WMRulerMargins *margins);
1642
1643 int WMGetTextInsertType(WMText *tPtr);
1644
1645 int WMGetTextBlocks(WMText *tPtr);
1646
1647 void WMSetCurrentTextBlock(WMText *tPtr, int current);
1648
1649 int WMGetCurrentTextBlock(WMText *tPtr);
1650
1651 void WMPrependTextBlock(WMText *tPtr, void *vtb);
1652
1653 void WMAppendTextBlock(WMText *tPtr, void *vtb);
1654
1655 void *WMRemoveTextBlock(WMText *tPtr);
1656
1657 void WMDestroyTextBlock(WMText *tPtr, void *vtb);
1658
1659 /* ....................................................................... */
1660
1661
1662 WMTabView *WMCreateTabView(WMWidget *parent);
1663
1664 void WMSetTabViewType(WMTabView *tPtr, WMTabViewType type);
1665
1666 void WMSetTabViewEnabled(WMTabView *tPtr, Bool flag);
1667
1668 void WMSetTabViewFont(WMTabView *tPtr, WMFont *font);
1669
1670 void WMAddItemInTabView(WMTabView *tPtr, WMTabViewItem *item);
1671
1672 void WMInsertItemInTabView(WMTabView *tPtr, int index, WMTabViewItem *item);
1673
1674 void WMRemoveTabViewItem(WMTabView *tPtr, WMTabViewItem *item);
1675
1676 WMTabViewItem *WMAddTabViewItemWithView(WMTabView *tPtr, WMView *view,
1677                                         int identifier, char *label);
1678
1679 WMTabViewItem *WMTabViewItemAtPoint(WMTabView *tPtr, int x, int y);
1680
1681 void WMSelectFirstTabViewItem(WMTabView *tPtr);
1682
1683 void WMSelectLastTabViewItem(WMTabView *tPtr);
1684
1685 void WMSelectNextTabViewItem(WMTabView *tPtr);
1686
1687 void WMSelectPreviousTabViewItem(WMTabView *tPtr);
1688
1689 WMTabViewItem *WMGetSelectedTabViewItem(WMTabView *tPtr);
1690
1691 void WMSelectTabViewItem(WMTabView *tPtr, WMTabViewItem *item);
1692
1693 void WMSelectTabViewItemAtIndex(WMTabView *tPtr, int index);
1694
1695 void WMSetTabViewDelegate(WMTabView *tPtr, WMTabViewDelegate *delegate);
1696
1697
1698 WMTabViewItem *WMCreateTabViewItemWithIdentifier(int identifier);
1699
1700 int WMGetTabViewItemIdentifier(WMTabViewItem *item);
1701
1702 void WMSetTabViewItemLabel(WMTabViewItem *item, char *label);
1703
1704 char *WMGetTabViewItemLabel(WMTabViewItem *item);
1705
1706 void WMSetTabViewItemView(WMTabViewItem *item, WMView *view);
1707
1708 WMView *WMGetTabViewItemView(WMTabViewItem *item);
1709
1710 void WMDestroyTabViewItem(WMTabViewItem *item);
1711
1712
1713 /* ....................................................................... */
1714
1715 WMBox *WMCreateBox(WMWidget *parent);
1716
1717 void WMSetBoxBorderWidth(WMBox *box, unsigned width);
1718
1719 void WMAddBoxSubview(WMBox *bPtr, WMView *view, Bool expand, Bool fill,
1720                      int minSize, int maxSize, int space);
1721
1722 void WMAddBoxSubviewAtEnd(WMBox *bPtr, WMView *view, Bool expand, Bool fill,
1723                           int minSize, int maxSize, int space);
1724
1725 void WMRemoveBoxSubview(WMBox *bPtr, WMView *view);
1726
1727 void WMSetBoxHorizontal(WMBox *box, Bool flag);
1728
1729 /* ....................................................................... */
1730
1731 int WMRunAlertPanel(WMScreen *app, WMWindow *owner, char *title, char *msg,
1732                     char *defaultButton, char *alternateButton,
1733                     char *otherButton);
1734
1735 /* you can free the returned string */
1736 char *WMRunInputPanel(WMScreen *app, WMWindow *owner, char *title, char *msg,
1737                       char *defaultText, char *okButton, char *cancelButton);
1738
1739 WMAlertPanel *WMCreateAlertPanel(WMScreen *app, WMWindow *owner, char *title,
1740                                  char *msg, char *defaultButton,
1741                                  char *alternateButton, char *otherButton);
1742
1743 WMInputPanel *WMCreateInputPanel(WMScreen *app, WMWindow *owner, char *title,
1744                                  char *msg, char *defaultText, char *okButton,
1745                                  char *cancelButton);
1746
1747
1748 WMGenericPanel *WMCreateGenericPanel(WMScreen *scrPtr, WMWindow *owner,
1749                                      char *title, char *defaultButton,
1750                                      char *alternateButton);
1751
1752 void WMDestroyAlertPanel(WMAlertPanel *panel);
1753
1754 void WMDestroyInputPanel(WMInputPanel *panel);
1755
1756 void WMDestroyGenericPanel(WMGenericPanel *panel);
1757
1758 /* ....................................................................... */
1759
1760 /* only 1 instance per WMScreen */
1761 WMOpenPanel *WMGetOpenPanel(WMScreen *scrPtr);
1762
1763 WMSavePanel *WMGetSavePanel(WMScreen *scrPtr);
1764
1765 void WMSetFilePanelCanChooseDirectories(WMFilePanel *panel, Bool flag);
1766
1767 void WMSetFilePanelCanChooseFiles(WMFilePanel *panel, Bool flag);
1768
1769 void WMSetFilePanelAutoCompletion(WMFilePanel *panel, Bool flag);
1770
1771 void WMSetFilePanelDirectory(WMFilePanel *panel, char *path);
1772
1773 /* you can free the returned string */
1774 char *WMGetFilePanelFileName(WMFilePanel *panel);
1775
1776 void WMFreeFilePanel(WMFilePanel *panel);
1777
1778 int WMRunModalFilePanelForDirectory(WMFilePanel *panel, WMWindow *owner,
1779                                     char *path, char *name, char **fileTypes);
1780
1781 void WMSetFilePanelAccessoryView(WMFilePanel *panel, WMView *view);
1782
1783 WMView *WMGetFilePanelAccessoryView(WMFilePanel *panel);
1784
1785
1786 /* ...................................................................... */
1787
1788 /* only 1 instance per WMScreen */
1789 WMFontPanel *WMGetFontPanel(WMScreen *scr);
1790
1791 void WMShowFontPanel(WMFontPanel *panel);
1792
1793 void WMHideFontPanel(WMFontPanel *panel);
1794
1795 void WMSetFontPanelFont(WMFontPanel *panel, WMFont *font);
1796
1797 /* you can free the returned string */
1798 char *WMGetFontPanelFontName(WMFontPanel *panel);
1799
1800 WMFont *WMGetFontPanelFont(WMFontPanel *panel);
1801
1802 #ifdef __cplusplus
1803 }
1804 #endif /* __cplusplus */
1805
1806 #endif
1807