WINGs/WINGs/WINGs.h

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