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