WINGs/WINGs.h

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