WINGs/WINGs.h

   1
   2
   3 #ifndef _WINGS_H_
   4 #define _WINGS_H_
   5
   6 #include <wraster.h>
   7 #include <X11/Xlib.h>
   8
   9 #define WINGS_H_VERSION  980930
  10
  11
  12
  13
  14
  15
  16 typedef unsigned long WMPixel;
  17
  18
  19 typedef struct {
  20     unsigned int width;
  21     unsigned int height;
  22 } WMSize;
  23
  24 typedef struct {
  25     int x;
  26     int y;
  27 } WMPoint;
  28
  29 typedef struct {
  30     WMPoint pos;
  31     WMSize size;
  32 } WMRect;
  33
  34 typedef struct {
  35     int position;
  36     int count;
  37 } WMRange;
  38
  39
  40 #define ClientMessageMask       (1L<<30)
  41
  42
  43 /* window stacking level */
  44 enum {
  45   WMNormalWindowLevel   = 0,
  46   WMFloatingWindowLevel  = 3,
  47   WMDockWindowLevel   = 5,
  48   WMSubmenuWindowLevel  = 10,
  49   WMMainMenuWindowLevel  = 20
  50 };
  51
  52 /* window attributes */
  53 enum {
  54   WMBorderlessWindowMask = 0,
  55   WMTitledWindowMask = 1,
  56   WMClosableWindowMask = 2,
  57   WMMiniaturizableWindowMask = 4,
  58   WMResizableWindowMask = 8
  59 };
  60
  61
  62 /* button types */
  63 typedef enum {
  64     /* 0 is reserved for internal use */
  65         WBTMomentaryPush = 1,
  66         WBTPushOnPushOff = 2,
  67         WBTToggle = 3,
  68         WBTSwitch = 4,
  69         WBTRadio = 5,
  70         WBTMomentaryChange = 6,
  71         WBTOnOff = 7,
  72         WBTMomentaryLight = 8
  73 } WMButtonType;
  74
  75 /* button behaviour masks */
  76 enum {
  77     WBBSpringLoadedMask =       (1 << 0),
  78         WBBPushInMask =         (1 << 1),
  79         WBBPushChangeMask =     (1 << 2),
  80         WBBPushLightMask =      (1 << 3),
  81         WBBStateLightMask =     (1 << 5),
  82         WBBStateChangeMask =    (1 << 6),
  83         WBBStatePushMask =      (1 << 7)
  84 };
  85
  86
  87 /* frame title positions */
  88 typedef enum {
  89     WTPNoTitle,
  90         WTPAboveTop,
  91         WTPAtTop,
  92         WTPBelowTop,
  93         WTPAboveBottom,
  94         WTPAtBottom,
  95         WTPBelowBottom
  96 } WMTitlePosition;
  97
  98
  99 /* relief types */
 100 typedef enum {
 101     WRFlat,
 102         WRSimple,
 103         WRRaised,
 104         WRSunken,
 105         WRGroove,
 106         WRRidge,
 107         WRPushed
 108 } WMReliefType;
 109
 110
 111 /* alignment types */
 112 typedef enum {
 113     WALeft,
 114         WACenter,
 115         WARight,
 116         WMJustified                    /* not valid for textfields */
 117 } WMAlignment;
 118
 119
 120 /* image position */
 121 typedef enum {
 122     WIPNoImage,
 123     WIPImageOnly,
 124     WIPLeft,
 125     WIPRight,
 126     WIPBelow,
 127     WIPAbove,
 128     WIPOverlaps
 129 } WMImagePosition;
 130
 131
 132 /* scroller arrow position */
 133 typedef enum {
 134     WSAMaxEnd,
 135         WSAMinEnd,
 136         WSANone
 137 } WMScrollArrowPosition;
 138
 139 /* scroller parts */
 140 typedef enum {
 141     WSNoPart,
 142         WSDecrementPage,
 143         WSIncrementPage,
 144         WSDecrementLine,
 145         WSIncrementLine,
 146         WSKnob,
 147         WSKnobSlot
 148 } WMScrollerPart;
 149
 150 /* usable scroller parts */
 151 typedef enum {
 152     WSUNoParts,
 153         WSUOnlyArrows,
 154         WSUAllParts
 155 } WMUsableScrollerParts;
 156
 157 /* matrix types */
 158 typedef enum {
 159     WMMRadioMode,
 160         WMMHighlightMode,
 161         WMMListMode,
 162         WMMTrackMode
 163 } WMMatrixTypes;
 164
 165
 166 /* text movement types */
 167 enum {
 168     WMIllegalTextMovement,
 169         WMReturnTextMovement,
 170         WMTabTextMovement,
 171         WMBacktabTextMovement,
 172         WMLeftTextMovement,
 173         WMRightTextMovement,
 174         WMUpTextMovement,
 175         WMDownTextMovement
 176 };
 177
 178
 179 /* system images */
 180 #define WSIReturnArrow                  1
 181 #define WSIHighlightedReturnArrow       2
 182 #define WSIScrollerDimple               3
 183 #define WSIArrowLeft                    4
 184 #define WSIHighlightedArrowLeft         5
 185 #define WSIArrowRight                   6
 186 #define WSIHighlightedArrowRight        7
 187 #define WSIArrowUp                      8
 188 #define WSIHighlightedArrowUp           9
 189 #define WSIArrowDown                    10
 190 #define WSIHighlightedArrowDown         11
 191
 192
 193 enum {
 194     WLDSSelected = (1 << 16),
 195         WLDSDisabled = (1 << 17),
 196         WLDSFocused = (1 << 18),
 197         WLDSIsBranch = (1 << 19)
 198 };
 199
 200 /* alert panel return values */
 201 enum {
 202     WAPRDefault = 0,
 203         WAPRAlternate = 1,
 204         WAPROther = -1,
 205         WAPRError = -2
 206 };
 207
 208
 209
 210 /* types of input observers */
 211 enum {
 212     WIReadMask = (1 << 0),
 213         WIWriteMask = (1 << 1),
 214         WIExceptMask = (1 << 2)
 215 };
 216
 217
 218
 219 typedef int W_Class;
 220
 221 enum {
 222     WC_Window = 0,
 223     WC_Frame = 1,
 224     WC_Label = 2,
 225     WC_Button = 3,
 226     WC_TextField = 4,
 227     WC_Scroller = 5,
 228     WC_ScrollView = 6,
 229     WC_List = 7,
 230     WC_Browser = 8,
 231     WC_PopUpButton = 9,
 232     WC_ColorWell = 10,
 233     WC_Slider = 11,
 234     WC_Matrix = 12,                    /* not ready */
 235     WC_SplitView = 13
 236 };
 237
 238 /* All widgets must start with the following structure
 239  * in that order. Used for typecasting to get some generic data */
 240 typedef struct W_WidgetType {
 241     W_Class widgetClass;
 242     struct W_View *view;
 243
 244 } W_WidgetType;
 245
 246
 247 #define WMWidgetClass(widget)   (((W_WidgetType*)(widget))->widgetClass)
 248 #define WMWidgetView(widget)    (((W_WidgetType*)(widget))->view)
 249
 250
 251 /* widgets */
 252
 253 typedef void WMWidget;
 254
 255 typedef struct W_Pixmap WMPixmap;
 256 typedef struct W_Font   WMFont;
 257 typedef struct W_Color  WMColor;
 258
 259 typedef struct W_Screen WMScreen;
 260
 261 typedef struct W_View WMView;
 262
 263 typedef struct W_Window WMWindow;
 264 typedef struct W_Frame WMFrame;
 265 typedef struct W_Button WMButton;
 266 typedef struct W_Label WMLabel;
 267 typedef struct W_TextField WMTextField;
 268 typedef struct W_Scroller WMScroller;
 269 typedef struct W_ScrollView WMScrollView;
 270 typedef struct W_List WMList;
 271 typedef struct W_Browser WMBrowser;
 272 typedef struct W_PopUpButton WMPopUpButton;
 273 typedef struct W_ColorWell WMColorWell;
 274 typedef struct W_Slider WMSlider;
 275 typedef struct W_Matrix WMMatrix;      /* not ready */
 276 typedef struct W_SplitView WMSplitView;
 277
 278 /* not widgets */
 279 typedef struct W_FilePanel WMFilePanel;
 280 typedef WMFilePanel WMOpenPanel;
 281 typedef WMFilePanel WMSavePanel;
 282
 283 typedef struct W_FontPanel WMFontPanel;
 284
 285
 286 /* item for WMList */
 287 typedef struct WMListItem {
 288     char *text;
 289     void *clientData;                  /* ptr for user clientdata. */
 290
 291     struct WMListItem *nextPtr;
 292
 293     unsigned int uflags:16;            /* flags for the user */
 294     unsigned int selected:1;
 295     unsigned int disabled:1;
 296     unsigned int isBranch:1;
 297     unsigned int loaded:1;
 298 } WMListItem;
 299
 300 /* struct for message panel */
 301 typedef struct WMAlertPanel {
 302     WMWindow *win;                     /* window */
 303     WMButton *defBtn;                  /* default button */
 304     WMButton *altBtn;                  /* alternative button */
 305     WMButton *othBtn;                  /* other button */
 306     WMLabel *iLbl;                     /* icon label */
 307     WMLabel *tLbl;                     /* title label */
 308     WMLabel *mLbl;                     /* message label */
 309     WMFrame *line;                     /* separator */
 310     short result;                      /* button that was pushed */
 311     short done;
 312
 313     KeyCode retKey;
 314 } WMAlertPanel;
 315
 316
 317 typedef struct WMInputPanel {
 318     WMWindow *win;                     /* window */
 319     WMButton *defBtn;                  /* default button */
 320     WMButton *altBtn;                  /* alternative button */
 321     WMLabel *tLbl;                     /* title label */
 322     WMLabel *mLbl;                     /* message label */
 323     WMTextField *text;                 /* text field */
 324     short result;                      /* button that was pushed */
 325     short done;
 326
 327     KeyCode retKey;
 328 } WMInputPanel;
 329
 330
 331
 332
 333
 334
 335
 336 typedef void *WMHandlerID;
 337
 338 typedef void WMInputProc(int fd, int mask, void *clientData);
 339
 340 typedef void WMEventProc(XEvent *event, void *clientData);
 341
 342 typedef void WMEventHook(XEvent *event);
 343
 344 /* self is set to the widget from where the callback is being called and
 345  * clientData to the data set to with WMSetClientData() */
 346 typedef void WMAction(WMWidget *self, void *clientData);
 347
 348
 349 typedef void WMCallback(void *data);
 350
 351
 352 /* delegate method like stuff */
 353 typedef void WMFreeDataProc(void *data);
 354
 355 typedef void WMListDrawProc(WMList *lPtr, Drawable d, char *text, int state,
 356                             WMRect *rect);
 357
 358 /*
 359 typedef void WMSplitViewResizeSubviewsProc(WMSplitView *sPtr,
 360                                            unsigned int oldWidth,
 361                                            unsigned int oldHeight);
 362 */
 363
 364 typedef void WMSplitViewConstrainProc(WMSplitView *sPtr, int dividerIndex,
 365                                       int *minCoordinate, int *maxCoordinate);
 366
 367 typedef WMWidget *WMMatrixCreateCellProc(WMMatrix *mPtr);
 368
 369
 370 typedef void WMBrowserFillColumnProc(WMBrowser *bPtr, int column);
 371
 372
 373 /* ....................................................................... */
 374
 375 void WMInitializeApplication(char *applicationName, int *argc, char **argv);
 376
 377 void WMSetApplicationDataPath(char *path);
 378
 379 /* don't free the returned string */
 380 char *WMGetApplicationName();
 381
 382 /* Try to locate resource file. ext may be NULL */
 383 char *WMPathForResourceOfType(char *resource, char *ext);
 384
 385 WMScreen *WMCreateScreenWithRContext(Display *display, int screen,
 386                                      RContext *context);
 387
 388 WMScreen *WMCreateScreen(Display *display, int screen);
 389
 390 WMScreen *WMCreateSimpleApplicationScreen(Display *display);
 391
 392 void WMScreenMainLoop(WMScreen *scr);
 393
 394
 395 RContext *WMScreenRContext(WMScreen *scr);
 396
 397 Display *WMScreenDisplay(WMScreen *scr);
 398
 399 int WMScreenDepth(WMScreen *scr);
 400
 401
 402
 403 void WMSetApplicationIconImage(WMScreen *app, WMPixmap *icon);
 404
 405 WMPixmap *WMGetApplicationIconImage(WMScreen *app);
 406
 407 void WMSetFocusToWidget(WMWidget *widget);
 408
 409 WMEventHook *WMHookEventHandler(WMEventHook *handler);
 410
 411 int WMHandleEvent(XEvent *event);
 412
 413 Bool WMScreenPending(WMScreen *scr);
 414
 415 void WMCreateEventHandler(WMView *view, unsigned long mask,
 416                           WMEventProc *eventProc, void *clientData);
 417
 418 void WMDeleteEventHandler(WMView *view, unsigned long mask,
 419                           WMEventProc *eventProc, void *clientData);
 420
 421 int WMIsDoubleClick(XEvent *event);
 422
 423 void WMNextEvent(Display *dpy, XEvent *event);
 424
 425 void WMMaskEvent(Display *dpy, long mask, XEvent *event);
 426
 427 WMHandlerID WMAddTimerHandler(int milliseconds, WMCallback *callback,
 428                               void *cdata);
 429
 430 void WMDeleteTimerWithClientData(void *cdata);
 431
 432 void WMDeleteTimerHandler(WMHandlerID handlerID);
 433
 434 WMHandlerID WMAddIdleHandler(WMCallback *callback, void *cdata);
 435
 436 void WMDeleteIdleHandler(WMHandlerID handlerID);
 437
 438 WMHandlerID WMAddInputHandler(int fd, int condition, WMInputProc *proc,
 439                               void *clientData);
 440
 441 void WMDeleteInputHandler(WMHandlerID handlerID);
 442
 443 /* ....................................................................... */
 444 /*
 445 void WMDragImageFromView(WMView *view, WMPixmap *image, WMPoint atLocation,
 446                          WMSize mouseOffset, XEvent *event, Bool slideBack);
 447
 448 */
 449
 450 /* ....................................................................... */
 451
 452 WMFont *WMCreateFont(WMScreen *scrPtr, char *fontName);
 453
 454 WMFont *WMCreateFontInDefaultEncoding(WMScreen *scrPtr, char *fontName);
 455
 456 WMFont *WMRetainFont(WMFont *font);
 457
 458 void WMReleaseFont(WMFont *font);
 459
 460 unsigned int WMFontHeight(WMFont *font);
 461
 462 /*
 463 WMFont *WMUserFontOfSize(WMScreen *scrPtr, int size);
 464
 465 WMFont *WMUserFixedPitchFontOfSize(WMScreen *scrPtr, int size);
 466 */
 467
 468 WMFont *WMSystemFontOfSize(WMScreen *scrPtr, int size);
 469
 470 WMFont *WMBoldSystemFontOfSize(WMScreen *scrPtr, int size);
 471
 472 XFontSet WMGetFontFontSet(WMFont *font);
 473
 474 /* ....................................................................... */
 475
 476 WMPixmap *WMRetainPixmap(WMPixmap *pixmap);
 477
 478 void WMReleasePixmap(WMPixmap *pixmap);
 479
 480 WMPixmap *WMCreatePixmapFromXPixmaps(WMScreen *scrPtr, Pixmap pixmap,
 481                                      Pixmap mask, int width, int height,
 482                                      int depth);
 483
 484 WMPixmap *WMCreatePixmapFromRImage(WMScreen *scrPtr, RImage *image,
 485                                    int threshold);
 486
 487 WMPixmap *WMCreatePixmapFromXPMData(WMScreen *scrPtr, char **data);
 488
 489 WMSize WMGetPixmapSize(WMPixmap *pixmap);
 490
 491 WMPixmap *WMCreatePixmapFromFile(WMScreen *scrPtr, char *fileName);
 492
 493 WMPixmap *WMCreateBlendedPixmapFromFile(WMScreen *scrPtr, char *fileName,
 494                                         RColor *color);
 495
 496 Pixmap WMGetPixmapXID(WMPixmap *pixmap);
 497
 498 Pixmap WMGetPixmapMaskXID(WMPixmap *pixmap);
 499
 500 WMPixmap *WMGetSystemPixmap(WMScreen *scr, int image);
 501
 502 /* ....................................................................... */
 503
 504
 505 WMColor *WMDarkGrayColor(WMScreen *scr);
 506
 507 WMColor *WMGrayColor(WMScreen *scr);
 508
 509 WMColor *WMBlackColor(WMScreen *scr);
 510
 511 WMColor *WMWhiteColor(WMScreen *scr);
 512
 513 void WMSetColorInGC(WMColor *color, GC gc);
 514
 515 GC WMColorGC(WMColor *color);
 516
 517 WMPixel WMColorPixel(WMColor *color);
 518
 519 void WMPaintColorSwatch(WMColor *color, Drawable d, int x, int y,
 520                         unsigned int width, unsigned int height);
 521
 522 void WMReleaseColor(WMColor *color);
 523
 524 WMColor *WMRetainColor(WMColor *color);
 525
 526 WMColor *WMCreateRGBColor(WMScreen *scr, unsigned short red,
 527                           unsigned short green, unsigned short blue,
 528                           Bool exact);
 529
 530 WMColor *WMCreateNamedColor(WMScreen *scr, char *name, Bool exact);
 531
 532 unsigned short WMRedComponentOfColor(WMColor *color);
 533
 534 unsigned short WMGreenComponentOfColor(WMColor *color);
 535
 536 unsigned short WMBlueComponentOfColor(WMColor *color);
 537
 538 char *WMGetColorRGBDescription(WMColor *color);
 539
 540 /* ....................................................................... */
 541
 542
 543 void WMDrawString(WMScreen *scr, Drawable d, GC gc, WMFont *font, int x,
 544                   int y, char *text, int length);
 545
 546 void WMDrawImageString(WMScreen *scr, Drawable d, GC gc, WMFont *font, int x,
 547                        int y, char *text, int length);
 548
 549 int WMWidthOfString(WMFont *font, char *text, int length);
 550
 551
 552
 553 /* ....................................................................... */
 554
 555 WMScreen *WMWidgetScreen(WMWidget *w);
 556
 557 void WMUnmapWidget(WMWidget *w);
 558
 559 void WMMapWidget(WMWidget *w);
 560
 561 void WMMoveWidget(WMWidget *w, int x, int y);
 562
 563 void WMResizeWidget(WMWidget *w, unsigned int width, unsigned int height);
 564
 565 void WMSetWidgetBackgroundColor(WMWidget *w, WMColor *color);
 566
 567 void WMMapSubwidgets(WMWidget *w);
 568
 569 void WMUnmapSubwidgets(WMWidget *w);
 570
 571 void WMRealizeWidget(WMWidget *w);
 572
 573 void WMDestroyWidget(WMWidget *widget);
 574
 575 void WMHangData(WMWidget *widget, void *data);
 576
 577 void *WMGetHangedData(WMWidget *widget);
 578
 579 unsigned int WMWidgetWidth(WMWidget *w);
 580
 581 unsigned int WMWidgetHeight(WMWidget *w);
 582
 583 Window WMWidgetXID(WMWidget *w);
 584
 585 Window WMViewXID(WMView *view);
 586
 587 void WMRedisplayWidget(WMWidget *w);
 588
 589 void WMSetViewNotifySizeChanges(WMView *view, Bool flag);
 590
 591 WMSize WMGetViewSize(WMView *view);
 592
 593 WMPoint WMGetViewPosition(WMView *view);
 594
 595 WMWidget *WMWidgetOfView(WMView *view);
 596
 597 /* notifications */
 598 extern char *WMViewSizeDidChangeNotification;
 599
 600 extern char *WMViewRealizedNotification;
 601
 602 /* ....................................................................... */
 603
 604 WMWindow *WMCreateWindow(WMScreen *screen, char *name);
 605
 606 WMWindow *WMCreateWindowWithStyle(WMScreen *screen, char *name, int style);
 607
 608 WMWindow *WMCreatePanelWithStyleForWindow(WMWindow *owner, char *name,
 609                                           int style);
 610
 611 WMWindow *WMCreatePanelForWindow(WMWindow *owner, char *name);
 612
 613 void WMChangePanelOwner(WMWindow *win, WMWindow *newOwner);
 614
 615 void WMSetWindowTitle(WMWindow *wPtr, char *title);
 616
 617 void WMSetWindowMiniwindowTitle(WMWindow *win, char *title);
 618
 619 void WMSetWindowMiniwindowImage(WMWindow *win, WMPixmap *pixmap);
 620
 621 void WMSetWindowCloseAction(WMWindow *win, WMAction *action, void *clientData);
 622
 623 void WMSetWindowMaxSize(WMWindow *win, unsigned width, unsigned height);
 624
 625 void WMSetWindowMinSize(WMWindow *win, unsigned width, unsigned height);
 626
 627 void WMSetWindowBaseSize(WMWindow *win, unsigned width, unsigned height);
 628
 629 void WMSetWindowResizeIncrements(WMWindow *win, unsigned wIncr, unsigned hIncr);
 630
 631 void WMSetWindowLevel(WMWindow *win, int level);
 632
 633 void WMSetWindowDocumentEdited(WMWindow *win, Bool flag);
 634
 635 void WMCloseWindow(WMWindow *win);
 636
 637 /* ....................................................................... */
 638
 639 void WMSetButtonAction(WMButton *bPtr, WMAction *action, void *clientData);
 640
 641 #define WMCreateCommandButton(parent) \
 642         WMCreateCustomButton((parent), WBBSpringLoadedMask\
 643                                         |WBBPushInMask\
 644                                         |WBBPushLightMask\
 645                                         |WBBPushChangeMask)
 646
 647 #define WMCreateRadioButton(parent) \
 648         WMCreateButton((parent), WBTRadio)
 649
 650 #define WMCreateSwitchButton(parent) \
 651         WMCreateButton((parent), WBTSwitch)
 652
 653 WMButton *WMCreateButton(WMWidget *parent, WMButtonType type);
 654
 655 WMButton *WMCreateCustomButton(WMWidget *parent, int behaviourMask);
 656
 657 void WMSetButtonImage(WMButton *bPtr, WMPixmap *image);
 658
 659 void WMSetButtonAltImage(WMButton *bPtr, WMPixmap *image);
 660
 661 void WMSetButtonImagePosition(WMButton *bPtr, WMImagePosition position);
 662
 663 void WMSetButtonFont(WMButton *bPtr, WMFont *font);
 664
 665 void WMSetButtonTextAlignment(WMButton *bPtr, WMAlignment alignment);
 666
 667 void WMSetButtonText(WMButton *bPtr, char *text);
 668
 669 void WMSetButtonAltText(WMButton *bPtr, char *text);
 670
 671 void WMSetButtonSelected(WMButton *bPtr, int isSelected);
 672
 673 int WMGetButtonSelected(WMButton *bPtr);
 674
 675 void WMSetButtonBordered(WMButton *bPtr, int isBordered);
 676
 677 void WMSetButtonEnabled(WMButton *bPtr, Bool flag);
 678
 679 void WMSetButtonTag(WMButton *bPtr, int tag);
 680
 681 void WMGroupButtons(WMButton *bPtr, WMButton *newMember);
 682
 683 void WMPerformButtonClick(WMButton *bPtr);
 684
 685 void WMSetButtonContinuous(WMButton *bPtr, Bool flag);
 686
 687 void WMSetButtonPeriodicDelay(WMButton *bPtr, float delay, float interval);
 688
 689 /* ....................................................................... */
 690
 691 WMLabel *WMCreateLabel(WMWidget *parent);
 692
 693 void WMSetLabelWraps(WMLabel *lPtr, Bool flag);
 694
 695 void WMSetLabelImage(WMLabel *lPtr, WMPixmap *image);
 696
 697 void WMSetLabelImagePosition(WMLabel *lPtr, WMImagePosition position);
 698
 699 void WMSetLabelTextAlignment(WMLabel *lPtr, WMAlignment alignment);
 700
 701 void WMSetLabelRelief(WMLabel *lPtr, WMReliefType relief);
 702
 703 void WMSetLabelText(WMLabel *lPtr, char *text);
 704
 705 void WMSetLabelFont(WMLabel *lPtr, WMFont *font);
 706
 707 void WMSetLabelTextColor(WMLabel *lPtr, WMColor *color);
 708
 709 /* ....................................................................... */
 710
 711 WMFrame *WMCreateFrame(WMWidget *parent);
 712
 713 void WMSetFrameTitlePosition(WMFrame *fPtr, WMTitlePosition position);
 714
 715 void WMSetFrameRelief(WMFrame *fPtr, WMReliefType relief);
 716
 717 void WMSetFrameTitle(WMFrame *fPtr, char *title);
 718
 719 /* ....................................................................... */
 720
 721 WMTextField *WMCreateTextField(WMWidget *parent);
 722
 723 void WMInsertTextFieldText(WMTextField *tPtr, char *text, int position);
 724
 725 void WMDeleteTextFieldRange(WMTextField *tPtr, WMRange range);
 726
 727 /* you can free the returned string */
 728 char *WMGetTextFieldText(WMTextField *tPtr);
 729
 730 void WMSetTextFieldText(WMTextField *tPtr, char *text);
 731
 732 void WMSetTextFieldAlignment(WMTextField *tPtr, WMAlignment alignment);
 733
 734 void WMSetTextFieldBordered(WMTextField *tPtr, Bool bordered);
 735
 736 void WMSetTextFieldEnabled(WMTextField *tPtr, Bool flag);
 737
 738 void WMSetTextFieldSecure(WMTextField *tPtr, Bool flag);
 739
 740
 741 extern char *WMTextDidChangeNotification;
 742 extern char *WMTextDidBeginEditingNotification;
 743 extern char *WMTextDidEndEditingNotification;
 744
 745 /* ....................................................................... */
 746
 747 WMScroller *WMCreateScroller(WMWidget *parent);
 748
 749 void WMSetScrollerParameters(WMScroller *sPtr, float floatValue,
 750                              float knobProportion);
 751
 752 float WMGetScrollerKnobProportion(WMScroller *sPtr);
 753
 754 float WMGetScrollerValue(WMScroller *sPtr);
 755
 756 WMScrollerPart WMGetScrollerHitPart(WMScroller *sPtr);
 757
 758 void WMSetScrollerAction(WMScroller *sPtr, WMAction *action, void *clientData);
 759
 760 void WMSetScrollerArrowsPosition(WMScroller *sPtr,
 761                                  WMScrollArrowPosition position);
 762
 763 /* ....................................................................... */
 764
 765 WMList *WMCreateList(WMWidget *parent);
 766
 767 #define WMAddListItem(lPtr, text) WMInsertListItem((lPtr), -1, (text))
 768
 769 WMListItem *WMInsertListItem(WMList *lPtr, int row, char *text);
 770
 771 WMListItem *WMAddSortedListItem(WMList *lPtr, char *text);
 772
 773 int WMFindRowOfListItemWithTitle(WMList *lPtr, char *title);
 774
 775 WMListItem *WMGetListItem(WMList *lPtr, int row);
 776
 777 void WMRemoveListItem(WMList *lPtr, int row);
 778
 779 void WMSelectListItem(WMList *lPtr, int row);
 780
 781 void WMSetListUserDrawProc(WMList *lPtr, WMListDrawProc *proc);
 782
 783 void WMSetListUserDrawItemHeight(WMList *lPtr, unsigned short height);
 784
 785 /* don't free the returned data */
 786 WMListItem *WMGetListSelectedItem(WMList *lPtr);
 787
 788 int WMGetListSelectedItemRow(WMList *lPtr);
 789
 790 void WMSetListAction(WMList *lPtr, WMAction *action, void *clientData);
 791
 792 void WMSetListDoubleAction(WMList *lPtr, WMAction *action, void *clientData);
 793
 794 void WMClearList(WMList *lPtr);
 795
 796 int WMGetListNumberOfRows(WMList *lPtr);
 797
 798 void WMSetListPosition(WMList *lPtr, int row);
 799
 800 void WMSetListBottomPosition(WMList *lPtr, int row);
 801
 802 int WMGetListPosition(WMList *lPtr);
 803
 804 /* ....................................................................... */
 805
 806 WMBrowser *WMCreateBrowser(WMWidget *parent);
 807
 808 void WMSetBrowserPathSeparator(WMBrowser *bPtr, char *separator);
 809
 810 void WMSetBrowserTitled(WMBrowser *bPtr, Bool flag);
 811
 812 void WMLoadBrowserColumnZero(WMBrowser *bPtr);
 813
 814 int WMAddBrowserColumn(WMBrowser *bPtr);
 815
 816 void WMRemoveBrowserItem(WMBrowser *bPtr, int column, int row);
 817
 818 void WMSetBrowserColumnTitle(WMBrowser *bPtr, int column, char *title);
 819
 820 WMListItem *WMAddSortedBrowserItem(WMBrowser *bPtr, int column, char *text, Bool isBranch);
 821
 822 WMListItem *WMInsertBrowserItem(WMBrowser *bPtr, int column, int row, char *text, Bool isBranch);
 823
 824 Bool WMSetBrowserPath(WMBrowser *bPtr, char *path);
 825
 826 /* you can free the returned string */
 827 char *WMGetBrowserPath(WMBrowser *bPtr);
 828 /* you can free the returned string */
 829 char *WMGetBrowserPathToColumn(WMBrowser *bPtr, int column);
 830
 831 void WMSetBrowserFillColumnProc(WMBrowser *bPtr,WMBrowserFillColumnProc *proc);
 832
 833 void WMSetBrowserAction(WMBrowser *bPtr, WMAction *action, void *clientData);
 834
 835 WMListItem *WMGetBrowserSelectedItemInColumn(WMBrowser *bPtr, int column);
 836
 837 int WMGetBrowserFirstVisibleColumn(WMBrowser *bPtr);
 838
 839 int WMGetBrowserSelectedColumn(WMBrowser *bPtr);
 840
 841 int WMGetBrowserSelectedRowInColumn(WMBrowser *bPtr, int column);
 842
 843 int WMGetBrowserNumberOfColumns(WMBrowser *bPtr);
 844
 845 WMList *WMGetBrowserListInColumn(WMBrowser *bPtr, int column);
 846
 847 extern char *WMBrowserDidScrollNotification;
 848
 849 /* ....................................................................... */
 850
 851 WMPopUpButton *WMCreatePopUpButton(WMWidget *parent);
 852
 853 void WMSetPopUpButtonAction(WMPopUpButton *sPtr, WMAction *action,
 854                             void *clientData);
 855
 856 void WMSetPopUpButtonPullsDown(WMPopUpButton *bPtr, Bool flag);
 857
 858 void WMAddPopUpButtonItem(WMPopUpButton *bPtr, char *title);
 859
 860 void WMInsertPopUpButtonItem(WMPopUpButton *bPtr, int index, char *title);
 861
 862 void WMRemovePopUpButtonItem(WMPopUpButton *bPtr, int index);
 863
 864 void WMSetPopUpButtonItemEnabled(WMPopUpButton *bPtr, int index, Bool flag);
 865
 866 void WMSetPopUpButtonSelectedItem(WMPopUpButton *bPtr, int index);
 867
 868 int WMGetPopUpButtonSelectedItem(WMPopUpButton *bPtr);
 869
 870 void WMSetPopUpButtonText(WMPopUpButton *bPtr, char *text);
 871
 872 /* don't free the returned data */
 873 char *WMGetPopUpButtonItem(WMPopUpButton *bPtr, int index);
 874
 875 int WMGetPopUpButtonNumberOfItems(WMPopUpButton *bPtr);
 876
 877 /* ....................................................................... */
 878
 879 WMColorWell *WMCreateColorWell(WMWidget *parent);
 880
 881 void WMSetColorWellColor(WMColorWell *cPtr, WMColor *color);
 882
 883 WMColor *WMGetColorWellColor(WMColorWell *cPtr);
 884
 885 /* ...................................................................... */
 886
 887 WMScrollView *WMCreateScrollView(WMWidget *parent);
 888
 889 void WMResizeScrollViewContent(WMScrollView *sPtr, unsigned int width,
 890                                unsigned int height);
 891
 892 void WMSetScrollViewHasHorizontalScroller(WMScrollView *sPtr, Bool flag);
 893
 894 void WMSetScrollViewHasVerticalScroller(WMScrollView *sPtr, Bool flag);
 895
 896 void WMSetScrollViewContentView(WMScrollView *sPtr, WMView *view);
 897
 898 void WMSetScrollViewRelief(WMScrollView *sPtr, WMReliefType type);
 899
 900 void WMSetScrollViewContentView(WMScrollView *sPtr, WMView *view);
 901
 902 WMScroller *WMGetScrollViewHorizontalScroller(WMScrollView *sPtr);
 903
 904 WMScroller *WMGetScrollViewVerticalScroller(WMScrollView *sPtr);
 905
 906 void WMSetScrollViewLineScroll(WMScrollView *sPtr, int amount);
 907
 908 void WMSetScrollViewPageScroll(WMScrollView *sPtr, int amount);
 909
 910 /* ....................................................................... */
 911
 912 WMSlider *WMCreateSlider(WMWidget *parent);
 913
 914 int WMGetSliderMinValue(WMSlider *slider);
 915
 916 int WMGetSliderMaxValue(WMSlider *slider);
 917
 918 int WMGetSliderValue(WMSlider *slider);
 919
 920 void WMSetSliderMinValue(WMSlider *slider, int value);
 921
 922 void WMSetSliderMaxValue(WMSlider *slider, int value);
 923
 924 void WMSetSliderValue(WMSlider *slider, int value);
 925
 926 void WMSetSliderContinuous(WMSlider *slider, Bool flag);
 927
 928 void WMSetSliderAction(WMSlider *slider, WMAction *action, void *data);
 929
 930 /* ....................................................................... */
 931
 932 /* only supports 2 subviews */
 933 WMSplitView *WMCreateSplitView(WMWidget *parent);
 934
 935 void WMAddSplitViewSubview(WMSplitView *sPtr, WMView *subview);
 936
 937 void WMAdjustSplitViewSubviews(WMSplitView *sPtr);
 938
 939 void WMSetSplitViewConstrainProc(WMSplitView *sPtr,
 940                                  WMSplitViewConstrainProc *proc);
 941
 942 /*
 943 void WMSetSplitViewResizeSubviewsProc(WMSplitView *sPtr,
 944                                       WMSplitViewResizeSubviewsProc *proc);
 945 */
 946
 947 int WMGetSplitViewDividerThickness(WMSplitView *sPtr);
 948
 949
 950 /* ....................................................................... */
 951
 952 int WMRunAlertPanel(WMScreen *app, WMWindow *owner, char *title, char *msg,
 953                     char *defaultButton, char *alternateButton,
 954                     char *otherButton);
 955
 956 /* you can free the returned string */
 957 char *WMRunInputPanel(WMScreen *app, WMWindow *owner, char *title, char *msg,
 958                       char *defaultText, char *okButton, char *cancelButton);
 959
 960 WMAlertPanel *WMCreateAlertPanel(WMScreen *app, WMWindow *owner, char *title,
 961                                  char *msg, char *defaultButton,
 962                                  char *alternateButton, char *otherButton);
 963
 964 WMInputPanel *WMCreateInputPanel(WMScreen *app, WMWindow *owner, char *title,
 965                                  char *msg, char *defaultText, char *okButton,
 966                                  char *cancelButton);
 967
 968 void WMDestroyAlertPanel(WMAlertPanel *panel);
 969
 970 void WMDestroyInputPanel(WMInputPanel *panel);
 971
 972 /* ....................................................................... */
 973
 974 /* only 1 instance per WMScreen */
 975 WMOpenPanel *WMGetOpenPanel(WMScreen *scrPtr);
 976
 977 WMSavePanel *WMGetSavePanel(WMScreen *scrPtr);
 978
 979 void WMSetFilePanelCanChooseDirectories(WMFilePanel *panel, int flag);
 980
 981 void WMSetFilePanelCanChooseFiles(WMFilePanel *panel, int flag);
 982
 983 void WMSetFilePanelDirectory(WMFilePanel *panel, char *path);
 984
 985 /* you can free the returned string */
 986 char *WMGetFilePanelFileName(WMFilePanel *panel);
 987
 988 void WMFreeFilePanel(WMFilePanel *panel);
 989
 990 int WMRunModalOpenPanelForDirectory(WMFilePanel *panel, WMWindow *owner,
 991                                     char *path, char *name, char **fileTypes);
 992
 993 int WMRunModalSavePanelForDirectory(WMFilePanel *panel, WMWindow *owner,
 994                                     char *path, char *name);
 995
 996 /* ...................................................................... */
 997
 998 /* only 1 instance per WMScreen */
 999 WMFontPanel *WMGetFontPanel(WMScreen *scr);
1000
1001 void WMShowFontPanel(WMFontPanel *panel);
1002
1003 void WMHideFontPanel(WMFontPanel *panel);
1004
1005 void WMSetFontPanelFont(WMFontPanel *panel, WMFont *font);
1006
1007 /* you can free the returned string */
1008 char *WMGetFontPanelFontName(WMFontPanel *panel);
1009
1010 WMFont *WMGetFontPanelFont(WMFontPanel *panel);
1011
1012 #endif
1013