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