WINGs/WINGs/WINGs.h

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