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