WINGs/WINGs/WINGs.h

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