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