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