WINGs/WINGs/WINGs.h

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