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