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