diff --git a/WINGs/WINGs/WINGs.h b/WINGs/WINGs/WINGs.h index 6569b3bf..42362dc4 100644 --- a/WINGs/WINGs/WINGs.h +++ b/WINGs/WINGs/WINGs.h @@ -575,7 +575,7 @@ typedef struct W_DragDestinationProcs { } WMDragDestinationProcs; -/* ...................................................................... */ +/* ---[ WINGs/wmisc.c ]--------------------------------------------------- */ WMPoint wmkpoint(int x, int y); @@ -589,7 +589,7 @@ WMRect wmkrect(int x, int y, unsigned int width, unsigned int height); #define wmkpoint(x, y) (WMPoint){(x), (y)} #endif -/* ....................................................................... */ +/* ---[ WINGs/wapplication.c ]-------------------------------------------- */ @@ -603,6 +603,7 @@ char* WMGetApplicationName(void); /* Try to locate resource file. ext may be NULL */ char* WMPathForResourceOfType(char *resource, char *ext); +/* ---[ WINGs/widgets.c ]------------------------------------------------- */ WMScreen* WMOpenScreen(const char *display); @@ -625,7 +626,9 @@ Display* WMScreenDisplay(WMScreen *scr); int WMScreenDepth(WMScreen *scr); +void WMSetFocusToWidget(WMWidget *widget); +/* ---[ WINGs/wappresource.c ]-------------------------------------------- */ void WMSetApplicationIconImage(WMScreen *app, RImage *image); @@ -640,7 +643,7 @@ WMPixmap* WMCreateApplicationIconBlendedPixmap(WMScreen *scr, RColor *color); void WMSetApplicationIconWindow(WMScreen *scr, Window window); -void WMSetFocusToWidget(WMWidget *widget); +/* ---[ WINGs/wevent.c ]-------------------------------------------------- */ WMEventHook* WMHookEventHandler(WMEventHook *handler); @@ -662,8 +665,12 @@ void WMNextEvent(Display *dpy, XEvent *event); void WMMaskEvent(Display *dpy, long mask, XEvent *event); +void WMSetViewNextResponder(WMView *view, WMView *responder); -/* ....................................................................... */ +void WMRelayToNextResponder(WMView *view, XEvent *event); + + +/* ---[ WINGs/selection.c ]----------------------------------------------- */ Bool WMCreateSelectionHandler(WMView *view, Atom selection, Time timestamp, @@ -678,7 +685,7 @@ Bool WMRequestSelection(WMView *view, Atom selection, Atom target, extern char *WMSelectionOwnerDidChangeNotification; -/* ....................................................................... */ +/* ---[ WINGs/dragcommon.c ]---------------------------------------------- */ WMArray* WMCreateDragOperationArray(int initialSize); @@ -689,6 +696,8 @@ WMDragOperationType WMGetDragOperationItemType(WMDragOperationItem* item); char* WMGetDragOperationItemText(WMDragOperationItem* item); +/* ---[ WINGs/dragsource.c ]---------------------------------------------- */ + void WMSetViewDragImage(WMView* view, WMPixmap *dragImage); void WMReleaseViewDragImage(WMView* view); @@ -709,18 +718,18 @@ void WMSetViewDraggable(WMView *view, WMDragSourceProcs *procs, WMPixmap *dragIm void WMUnsetViewDraggable(WMView *view); +/* ---[ WINGs/dragdestination.c ]----------------------------------------- */ + void WMRegisterViewForDraggedTypes(WMView *view, WMArray *acceptedTypes); void WMUnregisterViewDraggedTypes(WMView *view); void WMSetViewDragDestinationProcs(WMView *view, WMDragDestinationProcs *procs); -/* ....................................................................... */ +/* ---[ WINGs/wfont.c ]--------------------------------------------------- */ Bool WMIsAntialiasingEnabled(WMScreen *scrPtr); -/* ....................................................................... */ - WMFont* WMCreateFont(WMScreen *scrPtr, char *fontName); WMFont* WMCopyFontWithStyle(WMScreen *scrPtr, WMFont *font, WMFontStyle style); @@ -745,7 +754,16 @@ WMFont* WMSystemFontOfSize(WMScreen *scrPtr, int size); WMFont* WMBoldSystemFontOfSize(WMScreen *scrPtr, int size); -/* ....................................................................... */ +void WMDrawString(WMScreen *scr, Drawable d, WMColor *color, WMFont *font, + int x, int y, char *text, int length); + +void WMDrawImageString(WMScreen *scr, Drawable d, WMColor *color, + WMColor *background, WMFont *font, int x, int y, + char *text, int length); + +int WMWidthOfString(WMFont *font, char *text, int length); + +/* ---[ WINGs/wpixmap.c ]------------------------------------------------- */ WMPixmap* WMRetainPixmap(WMPixmap *pixmap); @@ -781,7 +799,7 @@ Pixmap WMGetPixmapMaskXID(WMPixmap *pixmap); WMPixmap* WMGetSystemPixmap(WMScreen *scr, int image); -/* ....................................................................... */ +/* ---[ WINGs/wcolor.c ]-------------------------------------------------- */ WMColor* WMDarkGrayColor(WMScreen *scr); @@ -829,21 +847,7 @@ unsigned short WMGetColorAlpha(WMColor *color); char* WMGetColorRGBDescription(WMColor *color); -/* ....................................................................... */ - - -void WMDrawString(WMScreen *scr, Drawable d, WMColor *color, WMFont *font, - int x, int y, char *text, int length); - -void WMDrawImageString(WMScreen *scr, Drawable d, WMColor *color, - WMColor *background, WMFont *font, int x, int y, - char *text, int length); - -int WMWidthOfString(WMFont *font, char *text, int length); - - - -/* ....................................................................... */ +/* ---[ WINGs/widgets.c ]------------------------------------------------- */ WMScreen* WMWidgetScreen(WMWidget *w); @@ -889,10 +893,12 @@ unsigned int WMWidgetHeight(WMWidget *w); Window WMWidgetXID(WMWidget *w); -Window WMViewXID(WMView *view); - void WMRedisplayWidget(WMWidget *w); +/* ---[ WINGs/wview.c ]--------------------------------------------------- */ + +Window WMViewXID(WMView *view); + void WMSetViewNotifySizeChanges(WMView *view, Bool flag); void WMSetViewExpandsToParent(WMView *view, int topOffs, int leftOffs, @@ -906,10 +912,6 @@ WMPoint WMGetViewScreenPosition(WMView *view); WMWidget* WMWidgetOfView(WMView *view); -void WMSetViewNextResponder(WMView *view, WMView *responder); - -void WMRelayToNextResponder(WMView *view, XEvent *event); - /* notifications */ extern char *WMViewSizeDidChangeNotification; @@ -917,8 +919,7 @@ extern char *WMViewFocusDidChangeNotification; extern char *WMViewRealizedNotification; - -/* ....................................................................... */ +/* ---[ WINGs/wballoon.c ]------------------------------------------------ */ void WMSetBalloonTextForView(char *text, WMView *view); @@ -933,7 +934,7 @@ void WMSetBalloonDelay(WMScreen *scr, int delay); void WMSetBalloonEnabled(WMScreen *scr, Bool flag); -/* ....................................................................... */ +/* ---[ WINGs/wwindow.c ]------------------------------------------------- */ WMWindow* WMCreateWindow(WMScreen *screen, char *name); @@ -977,7 +978,7 @@ void WMSetWindowDocumentEdited(WMWindow *win, Bool flag); void WMCloseWindow(WMWindow *win); -/* ....................................................................... */ +/* ---[ WINGs/wbutton.c ]------------------------------------------------- */ void WMSetButtonAction(WMButton *bPtr, WMAction *action, void *clientData); @@ -1041,7 +1042,7 @@ void WMSetButtonContinuous(WMButton *bPtr, Bool flag); void WMSetButtonPeriodicDelay(WMButton *bPtr, float delay, float interval); -/* ....................................................................... */ +/* ---[ WINGs/wlabel.c ]-------------------------------------------------- */ WMLabel* WMCreateLabel(WMWidget *parent); @@ -1067,7 +1068,7 @@ void WMSetLabelFont(WMLabel *lPtr, WMFont *font); void WMSetLabelTextColor(WMLabel *lPtr, WMColor *color); -/* ....................................................................... */ +/* ---[ WINGs/wframe.c ]-------------------------------------------------- */ WMFrame* WMCreateFrame(WMWidget *parent); @@ -1077,7 +1078,7 @@ void WMSetFrameRelief(WMFrame *fPtr, WMReliefType relief); void WMSetFrameTitle(WMFrame *fPtr, char *title); -/* ....................................................................... */ +/* ---[ WINGs/wtextfield.c ]---------------------------------------------- */ WMTextField* WMCreateTextField(WMWidget *parent); @@ -1124,7 +1125,7 @@ extern char *WMTextDidChangeNotification; extern char *WMTextDidBeginEditingNotification; extern char *WMTextDidEndEditingNotification; -/* ....................................................................... */ +/* ---[ WINGs/wscroller.c ]----------------------------------------------- */ WMScroller* WMCreateScroller(WMWidget *parent); @@ -1144,7 +1145,7 @@ void WMSetScrollerArrowsPosition(WMScroller *sPtr, extern char *WMScrollerDidScrollNotification; -/* ....................................................................... */ +/* ---[ WINGs/wlist.c ]--------------------------------------------------- */ WMList* WMCreateList(WMWidget *parent); @@ -1224,7 +1225,7 @@ Bool WMListAllowsEmptySelection(WMList *lPtr); extern char *WMListDidScrollNotification; extern char *WMListSelectionDidChangeNotification; -/* ....................................................................... */ +/* ---[ WINGs/wbrowser.c ]------------------------------------------------ */ WMBrowser* WMCreateBrowser(WMWidget *parent); @@ -1292,7 +1293,7 @@ Bool WMBrowserAllowsEmptySelection(WMBrowser *bPtr); void WMSetBrowserHasScroller(WMBrowser *bPtr, int hasScroller); -/* ....................................................................... */ +/* ---[ WINGs/wmenuitem.c ]----------------------------------------------- */ Bool WMMenuItemIsSeparator(WMMenuItem *item); @@ -1355,7 +1356,7 @@ WMMenu* WMGetMenuItemSubmenu(WMMenuItem *item); Bool WMGetMenuItemHasSubmenu(WMMenuItem *item); */ -/* ....................................................................... */ +/* ---[ WINGs/wpopupbutton.c ]-------------------------------------------- */ WMPopUpButton* WMCreatePopUpButton(WMWidget *parent); @@ -1392,7 +1393,7 @@ void WMSetPopUpButtonEnabled(WMPopUpButton *bPtr, Bool flag); Bool WMGetPopUpButtonEnabled(WMPopUpButton *bPtr); -/* ....................................................................... */ +/* ---[ WINGs/wcolorpanel.c ]--------------------------------------------- */ WMColorPanel* WMGetColorPanel(WMScreen *scrPtr); @@ -1412,7 +1413,7 @@ void WMSetColorPanelAction(WMColorPanel *panel, WMAction2 *action, void *data); extern char *WMColorPanelColorChangedNotification; -/* ....................................................................... */ +/* ---[ WINGs/wcolorwell.c ]---------------------------------------------- */ WMColorWell* WMCreateColorWell(WMWidget *parent); @@ -1426,7 +1427,7 @@ void WSetColorWellBordered(WMColorWell *cPtr, Bool flag); extern char *WMColorWellDidChangeNotification; -/* ...................................................................... */ +/* ---[ WINGs/wscrollview.c ]--------------------------------------------- */ WMScrollView* WMCreateScrollView(WMWidget *parent); @@ -1451,7 +1452,7 @@ void WMSetScrollViewLineScroll(WMScrollView *sPtr, int amount); void WMSetScrollViewPageScroll(WMScrollView *sPtr, int amount); -/* ....................................................................... */ +/* ---[ WINGs/wslider.c ]------------------------------------------------- */ WMSlider* WMCreateSlider(WMWidget *parent); @@ -1475,7 +1476,7 @@ void WMSetSliderKnobThickness(WMSlider *sPtr, int thickness); void WMSetSliderImage(WMSlider *sPtr, WMPixmap *pixmap); -/* ....................................................................... */ +/* ---[ WINGs/wsplitview.c ]---------------------------------------------- */ WMSplitView* WMCreateSplitView(WMWidget *parent); @@ -1508,7 +1509,7 @@ void WMSetSplitViewResizeSubviewsProc(WMSplitView *sPtr, int WMGetSplitViewDividerThickness(WMSplitView *sPtr); -/* ....................................................................... */ +/* ---[ WINGs/wtabview.c ]------------------------------------------------ */ WMTabView* WMCreateTabView(WMWidget *parent); @@ -1564,7 +1565,7 @@ WMView* WMGetTabViewItemView(WMTabViewItem *item); void WMDestroyTabViewItem(WMTabViewItem *item); -/* ....................................................................... */ +/* ---[ WINGs/wbox.c ]---------------------------------------------------- */ WMBox* WMCreateBox(WMWidget *parent); @@ -1580,7 +1581,7 @@ void WMRemoveBoxSubview(WMBox *bPtr, WMView *view); void WMSetBoxHorizontal(WMBox *box, Bool flag); -/* ....................................................................... */ +/* ---[ WINGs/wpanel.c ]-------------------------------------------------- */ int WMRunAlertPanel(WMScreen *app, WMWindow *owner, char *title, char *msg, char *defaultButton, char *alternateButton, @@ -1609,7 +1610,7 @@ void WMDestroyInputPanel(WMInputPanel *panel); void WMDestroyGenericPanel(WMGenericPanel *panel); -/* ....................................................................... */ +/* ---[ WINGs/wfilepanel.c ]---------------------------------------------- */ /* only 1 instance per WMScreen */ WMOpenPanel* WMGetOpenPanel(WMScreen *scrPtr); @@ -1637,7 +1638,7 @@ void WMSetFilePanelAccessoryView(WMFilePanel *panel, WMView *view); WMView* WMGetFilePanelAccessoryView(WMFilePanel *panel); -/* ...................................................................... */ +/* ---[ WINGs/wfontpanel.c ]---------------------------------------------- */ /* only 1 instance per WMScreen */ WMFontPanel* WMGetFontPanel(WMScreen *scr); diff --git a/WINGs/WINGs/WUtil.h b/WINGs/WINGs/WUtil.h index 4b2a9efd..19785d3d 100644 --- a/WINGs/WINGs/WUtil.h +++ b/WINGs/WINGs/WUtil.h @@ -160,12 +160,21 @@ typedef void WMNotificationObserverAction(void *observerData, WMNotification *notification); -/*......................................................................*/ +/* ---[ WINGs/memory.c ]-------------------------------------------------- */ + +void* wmalloc(size_t size); +void* wrealloc(void *ptr, size_t newsize); +void wfree(void *ptr); + +void wrelease(void *ptr); +void* wretain(void *ptr); typedef void waborthandler(int); waborthandler* wsetabort(waborthandler* handler); +/* ---[ WINGs/error.c ]--------------------------------------------------- */ + enum { WMESSAGE_TYPE_MESSAGE, WMESSAGE_TYPE_WARNING, @@ -181,6 +190,8 @@ enum { void __wmessage(const char *func, const char *file, int line, int type, const char *msg, ...) __attribute__((__format__(printf,5,6))); +/* ---[ WINGs/findfile.c ]------------------------------------------------ */ + char* wfindfile(char *paths, char *file); char* wfindfileinlist(char **path_list, char *file); @@ -189,18 +200,15 @@ char* wfindfileinarray(WMPropList* array, char *file); char* wexpandpath(char *path); -int wmkdirhier(const char *path); -int wrmdirhier(const char *path); - /* don't free the returned string */ char* wgethomedir(void); -void* wmalloc(size_t size); -void* wrealloc(void *ptr, size_t newsize); -void wfree(void *ptr); +/* ---[ WINGs/proplist.c ]------------------------------------------------ */ -void wrelease(void *ptr); -void* wretain(void *ptr); +int wmkdirhier(const char *path); +int wrmdirhier(const char *path); + +/* ---[ WINGs/string.c ]-------------------------------------------------- */ char *wstrdup(const char *str); char* wstrndup(const char *str, size_t len); @@ -234,18 +242,15 @@ void wtokenfree(char **tokens, int count); char* wtrimspace(const char *s); +/* ---[ WINGs/wmisc.c ]--------------------------------------------------- */ WMRange wmkrange(int start, int count); - -char* wusergnusteppath(void); - -char* wdefaultspathfordomain(char *domain); -char* wglobaldefaultspathfordomain(const char *domain); +/* ---[ WINGs/usleep.c ]-------------------------------------------------- */ void wusleep(unsigned int microsec); -/*......................................................................*/ +/* ---[ WINGs/handlers.c ]------------------------------------------------ */ /* Event handlers: timer, idle, input */ @@ -276,7 +281,7 @@ void WMDeleteInputHandler(WMHandlerID handlerID); void WHandleEvents(void); -/*......................................................................*/ +/* ---[ WINGs/hashtable.c ]----------------------------------------------- */ WMHashTable* WMCreateHashTable(WMHashTableCallbacks callbacks); @@ -337,7 +342,7 @@ extern const WMHashTableCallbacks WMStringPointerHashCallbacks; /* keys are strings, but they are not copied */ -/*......................................................................*/ +/* ---[ WINGs/array.c ]--------------------------------------------------- */ /* * WMArray use an array to store the elements. @@ -437,7 +442,7 @@ void* WMArrayPrevious(WMArray *array, WMArrayIterator *iter); for (var = WMArrayLast(array, &(i)); (i) != WANotFound; \ var = WMArrayPrevious(array, &(i))) -/*..........................................................................*/ +/* ---[ WINGs/bagtree.c ]------------------------------------------------- */ /* * Tree bags use a red-black tree for storage. @@ -529,7 +534,7 @@ int WMBagIndexForIterator(WMBag *bag, WMBagIterator ptr); -/*-------------------------------------------------------------------------*/ +/* ---[ WINGs/data.c ]---------------------------------------------------- */ /* WMData handling */ @@ -599,7 +604,7 @@ unsigned WMGetDataFormat(WMData *aData); /* Storing data */ -/*--------------------------------------------------------------------------*/ +/* ---[ WINGs/data.c ]---------------------------------------------------- */ WMNotification* WMCreateNotification(const char *name, void *object, void *clientData); @@ -645,7 +650,7 @@ void WMEnqueueCoalesceNotification(WMNotificationQueue *queue, unsigned coalesceMask); -/*......................................................................*/ +/* ---[ WINGs/proplist.c ]------------------------------------------------ */ /* Property Lists handling */ @@ -747,7 +752,13 @@ WMPropList* WMReadPropListFromFile(char *file); Bool WMWritePropListToFile(WMPropList *plist, char *path); -/*......................................................................*/ +/* ---[ WINGs/userdefaults.c ]-------------------------------------------- */ + +char* wusergnusteppath(void); + +char* wdefaultspathfordomain(char *domain); + +char* wglobaldefaultspathfordomain(const char *domain); WMUserDefaults* WMGetStandardUserDefaults(void);