WINGs/WINGs/WINGs.h

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