/*LINTLIBRARY*/ /* * SCCS_data: %Z% %M% %I% %E% %U% * * XpTable - Forms-based composite widget/geometry manager * Class heirarchy: * Core * Composite * XpTable * * Originally implemented by: * David Harrison * University of California, Berkeley * 1989 * * Completely re-implemented by: * David.Smyth@SniAp.MchP.SNI.De */ /* Edit History 25Oct92 david Geometry management re-work 01Feb92 david Re-Implementation */ #include #include #ifdef sun #include /* why don't they just use X from mit!?! */ #include #endif #include #include /* For backward compatibility with old Xt releases **=================================================** */ #ifndef XtIsWidget #ifdef XtSpecificationRelease #define XtIsWidget(obj) XtIsSubclass(obj,(WidgetClass)coreWidgetClass) #else #define XtIsWidget(obj) XtIsSubclass(obj,(WidgetClass)widgetClass) #endif #endif #ifndef XtSpecificationRelease #if NeedFunctionPrototypes typedef void* XtPointer; #else typedef char* XtPointer; #endif #endif /* Resources **===========** */ #ifdef XtOffsetOf #define OFFSET(field) XtOffsetOf(XpTableRec,table.field) #else #define OFFSET(field) XtOffset(XpTableWidget,table.field) #endif static XtResource resources[] = { { XtNdefaultOptions, XtCDefaultOptions, XtRXpTableOpts, sizeof(XpTableOpts), OFFSET(default_options), XtRImmediate, (XtPointer)0 }, { XtNlayout, XtCLayout, XtRXpTableLoc, sizeof(XpTableLoc), OFFSET(default_layout), XtRXpTableLoc, (XtPointer)0 }, { XtNsameWidth, XtCSameSize, XtRXrmNameListLists, sizeof(XrmNameListLists), OFFSET(same_width), XtRXrmNameListLists, (XtPointer)0 }, { XtNsameHeight, XtCSameSize, XtRXrmNameListLists, sizeof(XrmNameListLists), OFFSET(same_height), XtRXrmNameListLists, (XtPointer)0 }, { XtNsameBorder, XtCSameSize, XtRXrmNameListLists, sizeof(XrmNameListLists), OFFSET(same_border), XtRXrmNameListLists, (XtPointer)0 }, { XtNforceShrink, XtCForceShrink, XtRBoolean, sizeof(Boolean), OFFSET(force_shrink), XtRImmediate, (XtPointer)True }, { XtNshrinkSimple, XtCShrinkSimple, XtRBoolean, sizeof(Boolean), /*OBS*/ OFFSET(shrink_simple), XtRImmediate, (XtPointer)True }, /*OBS*/ { XtNcolumnSpacing, XtCSpacing, XtRInt, sizeof(int), OFFSET(col_spacing), XtRImmediate, (XtPointer)0 }, { XtNrowSpacing, XtCSpacing, XtRInt, sizeof(int), OFFSET(row_spacing), XtRImmediate, (XtPointer)0 }, { XtNmarginWidth, XtCMargins, XtRInt, sizeof(int), OFFSET(margin_width), XtRImmediate, (XtPointer)0 }, { XtNmarginHeight, XtCMargins, XtRInt, sizeof(int), OFFSET(margin_height), XtRImmediate, (XtPointer)0 }, }; #undef OFFSET /* Core Class Methods **====================** */ static void XpTableClassInitialize (); static void XpTableInitialize _(( Widget, Widget, ArgList, Cardinal* )); static void XpTableDestroy _(( Widget )); static void XpTableResize _(( Widget )); #ifdef XtSpecificationRelease static Boolean XpTableSetValues _(( Widget, Widget, Widget, ArgList, Cardinal* )); #else static Boolean XpTableSetValues _(( Widget, Widget, Widget )); #endif static XtGeometryResult XpTableQueryGeometry _(( Widget, XtWidgetGeometry*, XtWidgetGeometry* )); /* Composite class methods **=========================** */ static XtGeometryResult XpTableGeometryManager _(( Widget /*child*/, XtWidgetGeometry*, XtWidgetGeometry* )); static void XpTableChangeManaged _(( Widget )); XpTableClassRec xpTableClassRec = { { /* core_class fields */ /* superclass */ (WidgetClass)&compositeClassRec, /* class_name */ "XpTable", /* widget_size */ sizeof(XpTableRec), /* class_initialize */ XpTableClassInitialize, /* class_part_initialize */ NULL, /* class_inited */ FALSE, /* initialize */ XpTableInitialize, /* initialize_hook */ NULL, /* realize */ XtInheritRealize, /* actions */ NULL, /* num_actions */ 0, /* resources */ resources, /* num_resources */ XtNumber(resources), /* xrm_class */ NULLQUARK, /* compress_motion */ False, /* compress_exposure */ TRUE, /* compress_enterleave */ False, /* visible_interest */ FALSE, /* destroy */ XpTableDestroy, /* resize */ XpTableResize, /* expose */ XtInheritExpose, /* set_values */ XpTableSetValues, /* set_values_hook */ NULL, /* set_values_almost */ XtInheritSetValuesAlmost, /* get_values_hook */ NULL, /* accept_focus */ NULL, /* version */ XtVersion, /* callback_private */ NULL, /* tm_table */ XtInheritTranslations, /* query_geometry */ XpTableQueryGeometry, /* display_accelerator */ NULL, /* extension */ NULL }, { /* composite_class fields */ /* geometry_manager */ XpTableGeometryManager, /* change_managed */ XpTableChangeManaged, /* insert_child */ XtInheritInsertChild, /* delete_child */ XtInheritDeleteChild, /* extension */ NULL }, { /* table_class fields */ /* extension */ NULL } }; WidgetClass xpTableWidgetClass = (WidgetClass) &xpTableClassRec; /* Converters **============** */ /* Convert String to TableOpts **=============================** Converts a string representation into a TableOpts, which is small enough to fit entirely into the to->addr. */ /*ARGSUSED*/ void XpCvtStrToXpTableOpts( args, num_args, from, to ) XrmValue* args; /* Arguments to converter */ Cardinal* num_args; /* Number of arguments */ XrmValue* from; /* From type */ XrmValue* to; /* To type */ { static XpTableOpts opts; if (*num_args != 0) { XtErrorMsg("XpCvtStrToXpTableOpts", "wrongParameters", "XtToolkitError", "String to options takes no additional arguments", (String*)0, (Cardinal*)0); } opts = XpTableOptsParse( (String) from->addr ); if (opts == (XpTableOpts)0) XtStringConversionWarning( (String) from->addr, XtRXpTableOpts ); to->addr = (caddr_t) &opts; to->size = sizeof( XpTableOpts ); } /* Convert String to TableLocRec Array **=====================================** Converts a string representation into an array of TableLocRec structures (ie., TableLocRec*). This XtCalloc'd array is kept by the resource database: a COPY must be made by the widget. */ /*ARGSUSED*/ void XpCvtStrToXpTableLoc( args, num_args, from, to ) XrmValue* args; /* Arguments to converter */ Cardinal* num_args; /* Number of arguments */ XrmValue* from; /* From type */ XrmValue* to; /* To type */ { static XpTableLoc defLocs; if (*num_args != 0) { XtErrorMsg("XpCvtStrToXpTableLoc", "wrongParameters", "XtToolkitError", "String to layout takes no additional arguments", (String*)0, (Cardinal*)0); } defLocs = XpTableLocParse( (String) from->addr ); if (defLocs == (XpTableOpts)0) XtStringConversionWarning( (String) from->addr, XtRXpTableLoc ); to->addr = (caddr_t) &defLocs; to->size = sizeof(caddr_t); } /* Convert String to XrmNameList **===============================** Converts a string representation into a null-terminated array of XrmQuarks which will presumably name children widgets. This XtCalloc'd array is kept by the resource database: a COPY must be made by the widget. */ static XrmNameList XrmNameListParse _(( char*, char* )); static XrmNameListLists XrmNameListListsCopy _((XrmNameListLists)); /*ARGSUSED*/ void XpCvtStrToXrmNameListLists( args, num_args, from, to ) XrmValue* args; /* Arguments to converter */ Cardinal* num_args; /* Number of arguments */ XrmValue* from; /* From type */ XrmValue* to; /* To type */ { static XrmNameListLists listOfNameLists; if (*num_args != 0) { XtErrorMsg("XpCvtStrToXrmNameListLists", "wrongParameters", "XtToolkitError", "String to XrmNameListLists takes no additional arguments", (String*)0, (Cardinal*)0); } listOfNameLists = XrmNameListListsParse( (String) from->addr ); if (listOfNameLists == (XrmNameListLists)0) XtStringConversionWarning( (String) from->addr, XtRXrmNameListLists ); to->addr = (caddr_t) &listOfNameLists; to->size = sizeof(caddr_t); } #define LT_PAREN '(' #define RT_PAREN ')' XrmNameListLists XrmNameListListsParse( cp ) char* cp; { XrmNameList tempLists[1024]; /* lotsa possible lists... */ int numLists = 0; char* start; char* end; while ( *cp && isspace(*cp) ) ++cp; if ( *cp == LT_PAREN ) { /* More than one list */ while ( *cp == LT_PAREN ) { start = cp; /* start is LT_PAREN */ while ( *cp && *cp != RT_PAREN ) ++cp; end = cp; /* end is RT_PAREN or NUL */ tempLists[numLists++] = XrmNameListParse( start, end ); while ( *cp && *cp != LT_PAREN ) ++cp; } } else { /* exactly one list */ start = cp; /* start is not space, not LT_PAREN */ while (*cp) ++cp; end = cp; /* end is NUL */ tempLists[numLists++] = XrmNameListParse( start, end ); } if ( numLists > 0 ) { int i; XrmNameListLists retVal; retVal = (XrmNameListLists)XtCalloc( numLists+1, sizeof(XrmNameList) ); for ( i = 0 ; i < numLists ; ++i ) retVal[i] = tempLists[i]; return retVal; } return (XrmNameListLists)0; } #undef LT_PAREN #undef RT_PAREN /* Parse into an XtCalloc'd array of XrmNames ************************************************************************ start points to a LT_PAREN or to the 1st char of a name. end points to a RT_PAREN of a NUL. */ #define isname(c) (isalnum(c) || c == '_') static XrmNameList XrmNameListParse( start, end ) char* start; char* end; { XrmName tempList[1024]; /* may be lotsa kids */ int numNames = 0; char* cp = start; /* Get to first character of first name */ while ( cp < end && !isname(*cp) ) ++cp; while ( cp < end ) { char nameBuf[1024]; char* np = nameBuf; /* Get to first character of name */ while ( cp < end && !isname(*cp) ) ++cp; /* Collect name into buffer */ while ( cp < end && isname(*cp) ) *np++ = *cp++; *np = '\0'; tempList[numNames++] = XrmStringToQuark( nameBuf ); } if ( numNames > 0 ) { int i; XrmNameList retVal; retVal = (XrmNameList)XtCalloc( numNames+1, sizeof(XrmName) ); for ( i = 0 ; i < numNames ; ++i ) retVal[i] = tempList[i]; return retVal; } return (XrmNameList)0; } #undef isname static XrmNameListLists XrmNameListListsCopy( orig ) XrmNameListLists orig; { int list, name; XrmNameListLists copy; if ( orig == (XrmNameListLists)0 ) return (XrmNameListLists)0; for ( list = 0 ; orig[list] != (XrmNameList)0 ; ++list ) /*EMPTY*/; copy = (XrmNameListLists)XtCalloc( list+1, sizeof(XrmNameList) ); for ( list = 0 ; orig[list] != (XrmNameList)0 ; ++list ) { for ( name = 0 ; orig[list][name] != (XrmName)0 ; ++name ) /*EMPTY*/; copy[list] = (XrmNameList)XtCalloc( name+1, sizeof(XrmName) ); for ( name = 0 ; orig[list][name] != (XrmName)0 ; ++name ) copy[list][name] = orig[list][name]; } return copy; } void XrmNameListListsFree( old ) XrmNameListLists old; { int list; if ( old == (XrmNameListLists)0 ) return; for ( list = 0 ; old[list] != (XrmNameList)0 ; ++list ) XtFree( (char*)old[list] ); XtFree( (char*)old ); } /* Initialization Methods **========================** Note that no class part initialization is needed, as there are no inherited methods (yet?). */ static void XpTableClassInitialize() { XtAddConverter( XtRString, XtRXpTableOpts, XpCvtStrToXpTableOpts, (XtConvertArgList)0, 0 ); XtAddConverter( XtRString, XtRXpTableLoc, XpCvtStrToXpTableLoc, (XtConvertArgList)0, 0 ); XtAddConverter( XtRString, XtRXrmNameListLists, XpCvtStrToXrmNameListLists, (XtConvertArgList)0, 0 ); } /*ARGSUSED*/ static void XpTableInitialize( requestWidget, newWidget, args, num_args ) Widget requestWidget; /* as already set by Xt */ Widget newWidget; /* set up by this method */ ArgList args; Cardinal* num_args; { XpTableWidget tw = (XpTableWidget) newWidget; /* Copy resource values specified by pointer */ tw->table.default_layout = XpTableLocCopy( tw->table.default_layout); tw->table.same_width = XrmNameListListsCopy(tw->table.same_width); tw->table.same_height = XrmNameListListsCopy(tw->table.same_height); tw->table.same_border = XrmNameListListsCopy(tw->table.same_border); /* Initialize internally computed members */ tw->table.real_layout = (XpTableLoc)0; tw->table.num_cols = 0; tw->table.cols = (XpTableVector)0; tw->table.num_rows = 0; tw->table.rows = (XpTableVector)0; tw->table.resize_status = RSinit; tw->table.requesting_resize = False; tw->table.requesting_width = (Dimension)0; tw->table.requesting_height = (Dimension)0; tw->table.resize_child = (Widget)0; tw->table.resize_mode = (XtGeometryMask)0; tw->table.resize_width = (Dimension)0; tw->table.resize_height = (Dimension)0; tw->table.resize_border_width = (Dimension)0; tw->table.approved_child = (Widget)0; tw->table.approved_mode = (XtGeometryMask)0; tw->table.approved_width = (Dimension)0; tw->table.approved_height = (Dimension)0; tw->table.approved_border_width = (Dimension)0; tw->table.approved_cols = (XpTableVector)0; tw->table.approved_rows = (XpTableVector)0; tw->table.current_cols = (XpTableVector)0; tw->table.current_rows = (XpTableVector)0; tw->table.query_mode = (XtGeometryMask)0; tw->table.query_width = (Dimension)0; tw->table.query_height = (Dimension)0; tw->table.resize_table_to_size_pre_approved_by_parent = False; } /* Destroy Method **================** Free any instance data allocated for the TablePart members. */ static void XpTableDestroy( w ) Widget w; /* Widget to destroy */ { XpTableWidget tw = (XpTableWidget) w; XpTableLocFree( tw->table.default_layout ); XpTableLocFree( tw->table.real_layout ); XrmNameListListsFree( tw->table.same_width ); XrmNameListListsFree( tw->table.same_height ); XrmNameListListsFree( tw->table.same_border ); XpTableVectorFree( tw->table.cols ); XpTableVectorFree( tw->table.rows ); XpTableVectorFree( tw->table.approved_cols ); XpTableVectorFree( tw->table.approved_rows ); XpTableVectorFree( tw->table.current_cols ); XpTableVectorFree( tw->table.current_rows ); } /* Geometry Management and Negotiation **=====================================** The following methods are involved in geometry management and negotiation: TableResize() method: The parent can issue a resize demand by invoking TableResize() via XtResizeWidget(). This can be due to the parent being resized from above (perhaps the user changed the shell size via the window manager) or it may be due to the Table itself asking to be made a different size for any of several reasons. TableSetValues() method: Geometry management gets involved when a change occurs to any Table resource, or any of several superclass resources (width, height, margin_width). TableQueryGeometry() method: A parent of a Table asks the table for its preferred geometry using this method, invoked via XtQueryGeometry(). Usually generates a proposed layout which is valid only if the next geometry management and negotiation method invoked is TableQueryGeometry() for the same child asking for approved sizes. All other geometry management and negotiation methods must clear the proposed layout. TableGeometryManager() method: This method is invoked when a child wishes to become a different size. TableChangeManaged() method: this method is invoked when the set of managed children changes. This triggers the initial layout of the Table widget, and causes the existing layout to be re-computed. */ /* Recompute Layout Due To Parent Demand **=======================================** This gets called when a parent tells the table it must re-size. We certainly have real_layout, rows, cols, already done (or null if no managed children). If we are being resized due to the initial resize request from a child, then we will have alot of the work done IFF the size the table is now the size the parent *said* is would change the table to become. We cannot really trust this, because all this geometry negotiation stuff is so goddamn complex that one is amazed when anything actually DOES work... Therefore, if the table is being resized, and the size is as we expect, then we just resize and the optimizations work as planned. This means we can use the proposed column and row vectors which have already been adjusted to fit the pre-approved size, but we still size and position all the children, and redisplay. If we are being resized for any other reason, or if we are being resized to a size different from that previously approved by this tables's parent, then we need to flush the proposed layout stuff, and do a full resize: adjust the cols and rows to fit the table, size and position all the children, and redisplay. Cause the background of the Table widget to be re-displayed. */ static void XpTableResize( w ) Widget w; { XpTableWidget tw = (XpTableWidget)w; if ( tw->table.resize_table_to_size_pre_approved_by_parent && tw->core.width == tw->table.query_width && tw->core.height == tw->table.query_height ) { XpTableResizeLayout( tw ); } else { tw->table.resize_table_to_size_pre_approved_by_parent = False; XpTableForgetProposedLayout( tw ); XpTableResizeLayout( tw ); } } /* Set Values **============** This method gets called via XtSetValues(). If any table members or margin width have been changed, then geometry management must be done. We do not have to worry about geometry changes (core.width etc) because Xt takes care of invoking TableResize directly. */ #ifdef XtSpecificationRelease /*ARGSUSED*/ static Boolean XpTableSetValues( currentWidget, ignoreRequestWidget, newWidget, ignored, notUsed ) Widget currentWidget; /* Before call to XtSetValues */ Widget ignoreRequestWidget; /* After call to XtSetValues */ Widget newWidget; /* Final version of widget */ ArgList ignored; Cardinal* notUsed; #else static Boolean XpTableSetValues( currentWidget, ignoreRequestWidget, newWidget) Widget currentWidget; /* Before call to XtSetValues */ Widget ignoreRequestWidget; /* After call to XtSetValues */ Widget newWidget; /* Final version of widget */ #endif { XpTableWidget current = (XpTableWidget) currentWidget; XpTableWidget new = (XpTableWidget) newWidget; if ( current->table.force_shrink != new->table.force_shrink || current->table.col_spacing != new->table.col_spacing || current->table.row_spacing != new->table.row_spacing || current->table.default_options != new->table.default_options || current->table.default_layout != new->table.default_layout || current->table.same_width != new->table.same_width || current->table.same_height != new->table.same_height || current->table.same_border != new->table.same_border || current->table.margin_width != new->table.margin_width || current->table.margin_height != new->table.margin_height) { /* We need to do some re-layout */ XpTableForgetProposedLayout( new ); /* values set by pointers require special handling: * free old value, copy and alloc new value. */ if ( current->table.same_width != new->table.same_width ) { XrmNameListListsFree( current->table.same_width ); new->table.same_width = XrmNameListListsCopy( new->table.same_width ); } if ( current->table.same_height != new->table.same_height ) { XrmNameListListsFree( current->table.same_height ); new->table.same_height = XrmNameListListsCopy( new->table.same_height ); } if ( current->table.same_border != new->table.same_border ) { XrmNameListListsFree( current->table.same_border ); new->table.same_border = XrmNameListListsCopy( new->table.same_border ); } if ( current->table.default_layout != new->table.default_layout ) { XpTableLocFree( current->table.default_layout ); new->table.default_layout = XpTableLocCopy( new->table.default_layout ); /* We need to do a complete recomputation and placement */ XpTableNewLayout( new ); } else { /* we only need to change some things in the existing real_layout */ XpTableRecomputeLayout( new ); } /* Let Xt know exposure is needed */ return True; } /* No exposure needed due to Table resources */ return False; } /* Provide Preferred Geometry To Parent **======================================** If the parent asks if the table can grow, the answer is always yes. If the parent asks for the table to shrink to a size smaller than the preferred width or height, then the answer is almost, with the preferred width and height provided. */ static XtGeometryResult XpTableQueryGeometry( w, request, geo_return) Widget w; /* XpTable widget */ XtWidgetGeometry *request; /* Parent intended size */ XtWidgetGeometry *geo_return; /* preferred size */ { XpTableWidget tw = (XpTableWidget) w; int pref; /* First check for queries which would not result in a resize. * According to the spec, "No" means "Don't bother." */ if ( request->request_mode & CWWidth && request->width == tw->core.width && request->request_mode & CWHeight && request->height == tw->core.height ) return XtGeometryNo; if ( request->request_mode & CWWidth && request->width == tw->core.width ) return XtGeometryNo; if ( request->request_mode & CWHeight && request->height == tw->core.height ) return XtGeometryNo; /* Note that this table may be in the process of asking the parent for a * resize, and the parent may (from within the parent's GeometryManager * method) ask the table for its preferred size. TablePreferredWidth() * and TablePreferredHeight() can tell this is happening, because * TableMakeResizeRequest() sets the flag tw->table.requesting_resize. * In such a case, the preferred size returned is the size the table is * asking to become. */ if ( request->request_mode == (XtGeometryMask)0 ) { /* Parent is asking for all preferred dimensions */ geo_return->request_mode = CWWidth|CWHeight; geo_return->width = XpTablePreferredWidth( tw ); geo_return->height = XpTablePreferredHeight( tw ); } if ( request->request_mode & CWWidth ) { pref = XpTablePreferredWidth( tw ); if ( request->width < (Dimension)pref ) { geo_return->width = (Dimension)pref; geo_return->request_mode |= CWWidth; } else { geo_return->width = request->width; } } if ( request->request_mode & CWHeight ) { pref = XpTablePreferredHeight( tw ); if ( request->height < (Dimension)pref ) { geo_return->height = (Dimension)pref; geo_return->request_mode |= CWHeight; } else { geo_return->height = request->height; } } /* XtGeometryNo means already at preferred (minimum) size (dont't bother) */ if ( geo_return->width == tw->core.width && geo_return->height == tw->core.height ) return XtGeometryNo; /* XtGeometryAlmost means has a preferred size different from current size */ if ( geo_return->request_mode & (CWWidth|CWHeight) ) return XtGeometryAlmost; /* XtGeometryYes is only returned if request is to change geometry in ways * which do not matter to the table layout: x&y position, border_width, * sibling, and stack_mode. */ return XtGeometryYes; } /* Handle Geometry Requests from Children **========================================** Only called by Xt if the child is managed. Therefore, we can trust that the table already has valid row and column vectors. Position changes are always rejected. Size changes are processed as followed: We store the child and the child's requested size in the Table. We also save the current row and column vectors. Then we "pretend" that we are going to accept the requested child size: create new row and column vectors, make them fit the Table's width and height. Then, instead of changing the geometries of all the children, we see what the size of the requesting child would be. If (by some miracle) the resulatant size is the requested size, then we really do the layout. In reality, the size will almost ALWAYS be different from the requested, so we return XtGeometryAlmost, save the newly computed row and column vectors, and remember the approved size of the child. In most cases, the child will simply immediately re-invoke this method, passing the approved sizes. We can then use the pre-computed column and row vectors, and set the geometries of all the children (including the requesting child) and return XtGeometryDone (XtGeometryYes). If, however, ANY other geometry method is invoked (due to set values, change managed, or resize command from parent) then the pre-computed vectors are invalid, and the approved size is invalid. */ static XtGeometryResult XpTableGeometryManager( child, request, reply ) Widget child; /* Widget */ XtWidgetGeometry *request; /* Requested geometry change */ XtWidgetGeometry *reply; /* Actual reply to request */ { Widget parent = child->core.parent; XpTableWidget tw = (XpTableWidget) parent; Dimension width, height, border_width; if ( !parent || !XpIsTable( parent ) ) XtErrorMsg("XpTableGeometryManager", "badParent", "XtToolkitError", "Parent of widget is not an XpTableWidget", (String*)0, (Cardinal*)0); /* If request is only for geometry things ignored by table, do nothing. */ if ( 0 == request->request_mode & (CWWidth|CWHeight|CWBorderWidth)) return XtGeometryNo; /* Get the relevent dimensions of child: request or current. */ if ( request->request_mode & CWWidth ) width = request->width; else width = child->core.width; if ( request->request_mode & CWHeight ) height = request->height; else height = child->core.height; if ( request->request_mode & CWBorderWidth ) border_width = request->border_width; else border_width = child->core.border_width; /* Some widgets are really stupid: they ask to be resized to their * current size. Silly, but more common than you may think! */ if ( width == child->core.width && height == child->core.height && border_width == child->core.border_width ) { reply->width = width; reply->height = height; reply->border_width = border_width; reply->request_mode = ( request->request_mode & CWWidth ? CWWidth : 0 ) | ( request->request_mode & CWHeight ? CWHeight : 0 ) | ( request->request_mode & CWBorderWidth ? CWBorderWidth : 0 ); if ( request->request_mode & !(XtCWQueryOnly|CWWidth|CWHeight|CWBorderWidth) ) { /* There are some flags set which are not respected by Table */ return XtGeometryAlmost; } else if ( request->request_mode & XtCWQueryOnly ) { /* We will honor actual resize request for width, height, border */ return XtGeometryYes; } else { /* It is already the queried size. */ return XtGeometryDone; } } /* We can use the pre-computed proposed layout ONLY if the same child is * requesting pre-approved sizes. Note: approved_mode does NOT have * XtCWQueryOnly set! */ if ( tw->table.approved_child == child && tw->table.approved_mode == request->request_mode && tw->table.approved_width == width && tw->table.approved_height == height && tw->table.approved_border_width == border_width ) { /* Request is exactly as approved. */ XpTableUseProposedLayout( tw ); return XtGeometryDone; } /* No pre-approved layout, or something is different. Need to * re-compute proposed layout. */ XpTableForgetProposedLayout( tw ); /* Pretend we re-size the child, and go through table layout logic. Then * look at the resulting size of the child, and that will be the size we * approve for the child. If by some fluke the approved size is the size * requested, then we do the change, otherwise return Almost. */ tw->table.resize_child = child; tw->table.resize_mode = request->request_mode; tw->table.resize_width = width; tw->table.resize_height = height; tw->table.resize_border_width = border_width; XpTableNewProposedLayout( tw ); XpTableForgetResizeChild( tw ); reply->request_mode = tw->table.approved_mode; reply->width = tw->table.approved_width; reply->height = tw->table.approved_height; reply->border_width = tw->table.approved_border_width; /* Note: TableNewProposedLayout() will only set CWWidth or CWHeight or * CWBorderWidth into approved_mode. Therefore, if request_mode has * XtCWQueryOnly or any of the flags ignored by table (like CWStackMode) * then approved_mode will be different from request_mode */ if ( ( !(request->request_mode & CWWidth) || (tw->table.approved_width == width) ) && ( !(request->request_mode & CWHeight) || (tw->table.approved_height == height) ) && ( !(request->request_mode & CWBorderWidth) || (tw->table.approved_border_width == border_width) ) ) { /* Everything which is asked to change matched the approved changes. */ if ( (tw->table.approved_mode|XtCWQueryOnly) == request->request_mode ) { /* child only queried: we would grant child's request exactly */ return XtGeometryYes; } else if ( tw->table.approved_mode == request->request_mode ) { /* Request is exactly as approved. */ XpTableUseProposedLayout( tw ); return XtGeometryDone; } } if ( tw->table.approved_mode && ( tw->table.approved_width != child->core.width || tw->table.approved_height != child->core.height || tw->table.approved_border_width != child->core.border_width ) ) { /* Something is approved, and some approved size is different from * existing size, so some of the child's geometry would change. * approved_mode as provided by TableNewProposedLayout() already * reflects those fields which would actually change. */ return XtGeometryAlmost; } else { /* Approved size is exactly the same as current size. */ return XtGeometryNo; } } /* Handle Increase or Decrease in Managed Children **=================================================** Called when a child or when children are managed or unmanaged via XtManageChild(), XtUnmanageChild() etc. */ static void XpTableChangeManaged( w ) Widget w; { XpTableWidget tw = (XpTableWidget) w; XpTableNewLayout( tw ); } /*===========================** ** End Of Xt Invoked Methods ** **===========================*/ /* Internal Table Methods **========================** There are these ways the Table may need to be recomputed: o ChangedManage: Compute new layout, ask parent for new size. o SetValues: Compute new layout or recompute layout, ask parent for new size. o Child change: Recompute layout, ask parent for new size. o Initial GeometryRequest from child: Compute proposed layout. o Approved GeometryRequest from child: Use proposed layout, ask parent for new size. o Resize Method: Command to change to specific size from above. */ void XpTableNewLayout( tw ) XpTableWidget tw; { XpTableNewRealLayout( tw ); XpTableConsiderSameSize( tw ); XpTableNewColsAndRows( tw ); XpTableRequestResize( tw ); } void XpTableRecomputeLayout( tw ) XpTableWidget tw; { XpTableConsiderSameSize( tw ); XpTableNewColsAndRows( tw ); XpTableRequestResize( tw ); } void XpTableNewProposedLayout( tw ) XpTableWidget tw; { XpTableConsiderSameSize( tw ); XpTableProposedColsAndRows( tw ); XpTableQueryParentForResize( tw ); /* query only, no resize */ XpTableMakeColsFitQueryWidth( tw ); XpTableMakeRowsFitQueryHeight( tw ); XpTableGetProposedChildSize( tw ); XpTableSaveProposedLayout( tw ); } void XpTableUseProposedLayout( tw ) XpTableWidget tw; { XpTableGetProposedLayout( tw ); tw->table.resize_table_to_size_pre_approved_by_parent = True; XpTableRequestResize( tw ); tw->table.resize_table_to_size_pre_approved_by_parent = False; } /* Called due to TableRequestResize() */ void XpTableResizeLayout( tw ) XpTableWidget tw; { if ( !tw->table.resize_table_to_size_pre_approved_by_parent ) { XpTableMakeColsFitWidth( tw ); XpTableMakeRowsFitHeight( tw ); } XpTableSetGeometryOfChildren( tw ); /* I have to do this in case someone is using those goddamn gadgets. * Normally, a manager should not need to redisplay itself, right!?! */ if ( XtIsRealized( (Widget)tw ) ) { XClearArea( XtDisplay( (Widget)tw ), XtWindow( (Widget)tw ), 0, 0, 0, 0, /* clears entire window */ True ); /* we need Expose events */ } tw->table.resize_status = RSdone; } /* Proposed Layout Methods **=========================** A resize request from a child is virtually NEVER granted straight away: Instead, a proposed layout must be computed, and the resultant size of the child is then returned. If the child can accept this size (nearly always yes in actual existing widgets), then it immediately returns these approved sizes, and the table can detect this and use the proposed layout. If any other geometry method is invoked in the meantime, the proposed layout must be cleared and forgotten. */ void XpTableSaveProposedLayout( tw ) XpTableWidget tw; { tw->table.approved_cols = tw->table.cols; tw->table.approved_rows = tw->table.rows; tw->table.cols = tw->table.current_cols; tw->table.rows = tw->table.current_rows; } void XpTableGetProposedLayout( tw ) XpTableWidget tw; { XpTableVectorFree( tw->table.cols ); XpTableVectorFree( tw->table.rows ); tw->table.cols = tw->table.approved_cols; tw->table.rows = tw->table.approved_rows; tw->table.approved_child = (Widget)0; tw->table.approved_mode = (XtGeometryMask)0; tw->table.approved_width = (Dimension)0; tw->table.approved_height = (Dimension)0; tw->table.approved_border_width = (Dimension)0; tw->table.approved_cols = (XpTableVector)0; tw->table.approved_rows = (XpTableVector)0; } void XpTableForgetProposedLayout( tw ) XpTableWidget tw; { XpTableVectorFree( tw->table.approved_cols ); XpTableVectorFree( tw->table.approved_rows ); tw->table.approved_child = (Widget)0; tw->table.approved_mode = (XtGeometryMask)0; tw->table.approved_width = (Dimension)0; tw->table.approved_height = (Dimension)0; tw->table.approved_border_width = (Dimension)0; tw->table.approved_cols = (XpTableVector)0; tw->table.approved_rows = (XpTableVector)0; tw->table.current_cols = (XpTableVector)0; tw->table.current_rows = (XpTableVector)0; tw->table.query_mode = (XtGeometryMask)0; tw->table.query_width = (Dimension)0; tw->table.query_height = (Dimension)0; tw->table.resize_table_to_size_pre_approved_by_parent = False; } void XpTableForgetResizeChild( tw ) XpTableWidget tw; { tw->table.resize_child = (Widget)0; tw->table.resize_mode = (XtGeometryMask)0; tw->table.resize_width = (Dimension)0; tw->table.resize_height = (Dimension)0; tw->table.resize_border_width = (Dimension)0; } /* Build a new real_layout for all managed children. **==================================================** Each location is a function of the real_layout, default_layout, default_options, and automatic positioning. The list of managed children in traversed: if a managed child already appears in the current real_layout, that layout is copied. Otherwise, location data comes from default_layout, default_options, and automatic positioning members of the parent table widget. Since both the default_layout and real_layout are changed by TablePosition(), TableResize(), TableOptions(), and TableConfig(), changes to the children remain in effect when the table layout is re-computed, and when children become managed and unmanaged multiple times. However, if the default_layout is changed by a XtSetValues, all the positioning stuff in default_layout is lost. OK, since both are done by the client program: if the programmer wants to change the layout, the programmer will also need to reposition children. */ void XpTableNewRealLayout( tw ) XpTableWidget tw; { int num_children = tw->composite.num_children; WidgetList children = tw->composite.children; XpTableLoc result = XpTableLocNew( num_children ); XpTableLoc loc = result; XpTableLoc found; int child = 0; /* index into list of all children */ for ( ; child < num_children ; child++ ) { Widget w = children[child]; if ( XtIsManaged( w ) ) { /*ASSIGN_IN_IF*/ if ( found = XpTableLocFind( tw->table.real_layout, w ) ) { /* This widget was in previous layout, copy all fields */ *loc = *found; } /*ASSIGN_IN_IF*/ else if ( found = XpTableLocFind( tw->table.default_layout, w ) ) { /* This child has been laid out before, so copy everything. */ *loc = *found; } /*ASSIGN_IN_IF*/ else if ( found = XpTableLocFindDefault( tw->table.default_layout, w ) ) { /* Never laid out this child, but default layout provides * some information. Copy everything, fill in the blanks * (col,row,col_span,row_span already have defaults). * No problem if tw->table.default_options is zero. */ *loc = *found; loc->w = w; loc->orig_width = w->core.width; loc->orig_height = w->core.height; loc->orig_border_width = w->core.border_width; if ( !loc->options ) loc->options = tw->table.default_options; XpTableAppendToDefaultLayout( tw, loc ); } else { /* Never laid out this child, not in default layout. Fill * in everything with default values. */ loc->w = w; loc->w_quark = w->core.xrm_name; loc->col = loc->row = 0; loc->col_span = loc->row_span = 1; loc->orig_width = w->core.width; loc->orig_height = w->core.height; loc->orig_border_width = w->core.border_width; if ( !loc->options ) loc->options = tw->table.default_options; XpTableAppendToDefaultLayout( tw, loc ); } loc++; /* loc only incremented for MANAGED children */ } } XpTableLocFree( tw->table.real_layout ); tw->table.real_layout = result; } /* Append loc to default_layout **==============================** The loc points to a Widget child. When that child is destroyed, we must clear out that pointer, as it will point to deallocated data. */ static void XpTableRemoveFromDefaultLayoutCB _((Widget,XtPointer,XtPointer)); void XpTableAppendToDefaultLayout( tw, loc ) XpTableWidget tw; XpTableLoc loc; { int inx; tw->table.default_layout = XpTableLocGrow( tw->table.default_layout ); inx = XpTableLocLen( tw->table.default_layout ); tw->table.default_layout[inx] = *loc; XtAddCallback( loc->w, XtNdestroyCallback, XpTableRemoveFromDefaultLayoutCB, (XtPointer)tw ); } /* Remove Destroyed Widget from default_layout **=============================================** */ /*ARGSUSED*/ static void XpTableRemoveFromDefaultLayoutCB( w, client, call ) Widget w; XtPointer client, call; { XpTableWidget tw = (XpTableWidget)client; XpTableLoc loc = XpTableLocFind( tw->table.default_layout, w ); if ( loc ) loc->w = (Widget)0; } /* Consider Same Size constraints on all children in real_layout **===============================================================** ALWAYS do this BEFORE creating new or proposed columns and rows. New TableVectors need this information to determine the `preferred' sizes of children. This MAY happen when we are responding to a resize request from a child: in this case, we need to consider the resize request size instead of that specific child's current size. */ void XpTableConsiderSameSize( tw ) XpTableWidget tw; { XpTableLoc loc, real_layout; int same_what; real_layout = tw->table.real_layout; for ( loc = real_layout ; loc->w_quark != NULLQUARK ; loc++ ) { loc->same_width = 0; loc->same_height = 0; loc->same_border = 0; } for ( same_what = 1 ; same_what <= 3 ; ++same_what ) { XrmNameListLists lists; int list; switch ( same_what ) { case 1: lists = tw->table.same_width; break; case 2: lists = tw->table.same_height; break; case 3: lists = tw->table.same_border; break; } /* Go down all the lists of lists of names ... */ for ( list = 0 ; lists != NULL && lists[list] != NULL ; ++list ) { /* Go down all the names on each list to determine the max dimension */ XrmNameList names = lists[list]; int name; Dimension max; for ( max = name = 0 ; names[name] != (XrmName)0 ; ++name ) { /* Go down entire list of children, and for each kid * with this name get the maximum size. */ for ( loc = real_layout ; loc->w_quark != NULLQUARK ; loc++) { Widget kid = loc->w; if ( kid != (Widget)0 && kid->core.xrm_name == names[name] ) { #define MAXX(v) (max>v?max:v) if ( kid == tw->table.resize_child ) { switch ( same_what ) { case 1: max = MAXX( tw->table.resize_width ); break; case 2: max = MAXX( tw->table.resize_height ); break; case 3: max = MAXX( tw->table.resize_border_width ); break; } } else { switch ( same_what ) { case 1: max = MAXX( kid->core.width ); break; case 2: max = MAXX( kid->core.height ); break; case 3: max = MAXX( kid->core.border_width ); break; } } #undef MAXX } } } /* OK, we now have the maximum dimension. Apply to all * kids with names on this list. */ for ( name = 0 ; names[name] != (XrmName)0 ; ++name ) { for ( loc = real_layout ; loc->w_quark != NULLQUARK ; loc++) { Widget kid = loc->w; if ( kid != (Widget)0 && kid->core.xrm_name == names[name] ) { switch ( same_what ) { case 1: loc->same_width = max; break; case 2: loc->same_height = max; break; case 3: loc->same_border = max; break; } } } } } } } /* Create New Cols and Rows Vectors **==================================** This must be done whenever a new real_layout is created, or when the existing real_layout has been changed. */ void XpTableNewColsAndRows( tw ) XpTableWidget tw; { XpTableVectorFree( tw->table.cols ); XpTableVectorFree( tw->table.rows ); tw->table.num_cols = XpTableLocNumCols( tw->table.real_layout ); tw->table.num_rows = XpTableLocNumRows( tw->table.real_layout ); if ( tw->table.num_cols && tw->table.num_rows ) { tw->table.cols = XpTableVectorNew( tw->table.num_cols, tw, DO_COL ); tw->table.rows = XpTableVectorNew( tw->table.num_rows, tw, DO_ROW ); } else { tw->table.num_cols = tw->table.num_rows = 0; tw->table.cols = tw->table.rows = (XpTableVector)0; } } /* Create New Cols and Rows Vectors for Proposed Layout **======================================================** Save the "real" valid vectors for later. Note that we CERTAINLY have rows and columns, because this is only invoked due to a child's request to resize, and only managed children will be processed, and the existence of managed children implies the existence of non-null row and column vectors. */ void XpTableProposedColsAndRows( tw ) XpTableWidget tw; { tw->table.current_cols = tw->table.cols; tw->table.current_rows = tw->table.rows; tw->table.cols = XpTableVectorNew( tw->table.num_cols, tw, DO_COL ); tw->table.rows = XpTableVectorNew( tw->table.num_rows, tw, DO_ROW ); } /* Adjust rows and columns to fit **================================** These procedures are called when the Table's parent changes the size of the Table. The TableRecomputeLayout() procedure computes the preferred size of the table based on the layout and the children, with the assumption that the table could be any size. Now, we have a specific size, so we will need to adjust everything to fit. If the new size is larger, then its easy: just expand the space available to each row and/or column, and change the geometries of all the children. If the new size is smaller and force_shrink is true (the new default), then adjust all children to fit the new size. If the new size is smaller and force_shrink is false then we must do something like a better behaved version of the old behavior: Shrink to the preferred size but no smaller. */ void XpTableMakeColsFitWidth( tw ) XpTableWidget tw; { XpTableFitThis( tw, DO_COL, tw->core.width ); } void XpTableMakeColsFitQueryWidth( tw ) XpTableWidget tw; { XpTableFitThis( tw, DO_COL, tw->table.query_width ); } void XpTableMakeRowsFitHeight( tw ) XpTableWidget tw; { XpTableFitThis( tw, DO_ROW, tw->core.height ); } void XpTableMakeRowsFitQueryHeight( tw ) XpTableWidget tw; { XpTableFitThis( tw, DO_ROW, tw->table.query_height ); } void XpTableFitThis( tw, do_col, to_fit ) XpTableWidget tw; int do_col, to_fit; { int change, current, prefer, num; XpTableVector vec; if ( do_col ) { vec = tw->table.cols; num = tw->table.num_cols; } else { vec = tw->table.rows; num = tw->table.num_rows; } current = XpTableVectorTotalSize( vec, num, tw, do_col ); prefer = XpTableVectorPreferredSize( vec, num, tw, do_col ); if ( to_fit < prefer && tw->table.force_shrink == False ) { /* Smallest size is preferred size. Excess clipped. */ change = prefer - current; } else { change = to_fit - current; } if ( change != 0 ) XpTableVectorAdjust( vec, num, change ); } /* Determine Preferred (Minimum) Size of Table **=============================================** */ int XpTablePreferredWidth( tw ) XpTableWidget tw; { if ( tw->table.requesting_resize ) { return tw->table.requesting_width; } else { XpTableVector vec = tw->table.cols; int num = tw->table.num_cols; return XpTableVectorPreferredSize( vec, num, tw, DO_COL ); } } int XpTablePreferredHeight( tw ) XpTableWidget tw; { if ( tw->table.requesting_resize ) { return tw->table.requesting_height; } else { XpTableVector vec = tw->table.rows; int num = tw->table.num_rows; return XpTableVectorPreferredSize( vec, num, tw, DO_ROW ); } } /* Request Resize from Parent **============================** This procedure gets called by other Table methods when the Table instance wants to grow or shrink. Since we cannot yet tell if the desired size is OK, the children of the Table have NOT been sized or positioned: this is only done by the TableResize method. Here is when the wonders of Xt Geometry Management come into play. We cannot tell a priori what the hell is going to happen here. We can ask the parent to allow the table to resize based on the computed width and height of the cols and rows. If the parent says yes, then TableResize may, or then again, may not, have been called. Since we don't know, we must keep a bogus little flag in the instance to indicate what really happened. */ void XpTableRequestResize( tw ) XpTableWidget tw; { XtGeometryResult result; XtWidgetGeometry desired, approved; /* If this is RSdone after the call to XtMakeResizeRequest(), then we know * that TableResize() has been invoked. Otherwise, we must invoke * TableResize() directly. */ tw->table.resize_status = RSdueToRequest; /* We may be requesting a resize after a child asked for a resize. * In this case, we already have a size pre-approved by the parent. * Otherwise, we want to become our preferred size. */ if ( tw->table.resize_table_to_size_pre_approved_by_parent ) { desired.width = tw->table.query_width; desired.height = tw->table.query_height; desired.request_mode = tw->table.query_mode; } else { desired.width = XpTablePreferredWidth( tw ); desired.height = XpTablePreferredHeight( tw ); desired.request_mode = (XtGeometryMask)0; if ( desired.width != tw->core.width ) desired.request_mode |= CWWidth; if ( desired.width != tw->core.height ) desired.request_mode |= CWHeight; } /* XtMakeResizeRequest() asks the parent to allow this table to resize. * The parent, a Composite widget, will often need to query all of its * children (including this table) to see what sizes they want to be. * Therefore, there is a very good chance that the QueryGeometry method of * this table widget will be invoked in a few microseconds, and this table * will need to compute its desired size. So, for efficiency we remember * our desired size. */ tw->table.requesting_resize = True; tw->table.requesting_width = desired.width; tw->table.requesting_height = desired.height; /* If desired size is current size, then do NOT ask parent, act like its OK. */ if ( desired.width == tw->core.width && desired.height == tw->core.height ) result = XtGeometryYes; else result = XtMakeGeometryRequest( (Widget)tw, &desired, &approved ); /* Nothing special to do if XtGeometryYes or XtGeometryNo */ if ( result == XtGeometryAlmost ) { /* Now the desired size is the size our parent will allow. */ result = XtMakeGeometryRequest( (Widget)tw, &approved, &approved ); } tw->table.requesting_resize = False; /* No matter what the outcome, the Table must be "resized", as this is * where the table looks at its actual width/height and sizes and positions * the children widgets. */ if ( tw->table.resize_status == RSdueToRequest ) XpTableResize( (Widget)tw ); } /* Query parent for hypothetical resize. **======================================** This is called when a child has asked to be resized, and such a request, if granted, would cause the table to ask its parent for a resize. We ask the parent to tell us what size the parent would resize the table, if the table really asked for a resize to its "proposed" size. Note that we DO NOT ask the parent to resize us, because we are not COMPLETELY certain the child will want the size we will propose for it: the child may withdraw its resize. Unfortunately, the GeometryManager method of the parent may not in fact treat this as a simple query, but it may treat it as a request, and the table may well have its size changed by a call to its Resize method! Yes, this is a common deficiency in GeometryManager methods of composite widgets. It is VERY difficult to get all this &$%?%$!?! right. */ void XpTableQueryParentForResize( tw ) XpTableWidget tw; { XtGeometryResult result; XtWidgetGeometry desired, query; /* If this is RSdone after the call to XtMakeGeometryRequest(), then we * know that TableResize() has been invoked - UNFORTUNATELY! */ tw->table.resize_status = RSdueToRequest; /* Query only for width and height */ desired.request_mode = (XtCWQueryOnly|CWWidth|CWHeight); /* Desired dimensions reflect change due to resize_child's resize request */ desired.width = XpTablePreferredWidth( tw ); desired.height = XpTablePreferredHeight( tw ); /* XtMakeGeometryRequest() asks the parent for the result of a hypothetical * resize request from the table. The parent, a Composite widget, will * often need to query all of its children (including this table) to see * what sizes they want to be. Therefore, there is a very good chance that * the QueryGeometry method of this table widget will be invoked in a few * microseconds, and this table will need to compute its desired size. So, * for efficiency we remember our desired size. */ tw->table.requesting_resize = True; tw->table.requesting_width = desired.width; tw->table.requesting_height = desired.height; /* If desired size is current size, then do NOT ask parent, act like its OK. */ if ( desired.width == tw->core.width && desired.height == tw->core.height ) result = XtGeometryYes; else result = XtMakeGeometryRequest( (Widget)tw, &desired, &query ); tw->table.requesting_resize = False; switch ( result ) { case XtGeometryYes: tw->table.query_mode = CWWidth | CWHeight; tw->table.query_width = desired.width; tw->table.query_height = desired.height; break; case XtGeometryAlmost: tw->table.query_mode = ( query.request_mode & CWWidth ? CWWidth : 0 ) |( query.request_mode & CWHeight? CWWidth : 0 ); tw->table.query_width = query.width; tw->table.query_height = query.height; break; case XtGeometryNo: default: /* Cannot resize. */ tw->table.query_mode = (XtGeometryMask)0; tw->table.query_width = tw->core.width; tw->table.query_height = tw->core.height; break; } if ( result == XtGeometryYes && tw->table.resize_status != RSdueToRequest ) { /* Oh Shit! The parent did not notice this was just a QUERY, and * it went ahead and did the change. Oh Shit! */ Widget parent = XtParent( (Widget)tw ); char* class = parent->core.widget_class->core_class.class_name; String args[3]; Cardinal two = 2; args[0] = XtName(parent); args[1] = class; args[2] = NULL; XtWarningMsg( "brokenParent", "XpTableQueryParentForResize", "Widget Library Error", "Widget %s of class %s\nhas a GeometryManager method which ignores XtCWQueryOnly!", args, &two ); /* Already resized. */ tw->table.query_mode = (XtGeometryMask)0; tw->table.query_width = tw->core.width; tw->table.query_height = tw->core.height; } } /* Get Approved Size of Child **============================** A child has asked to be resized. We need to compute the size which the table would make the child if the table itself was resized (from above). Assume we will grant the border width request UNLESS the width or height goes to zero or negative. The child is managed (or else it could not make the resize request), so the child is in the real_layout. */ void XpTableGetProposedChildSize( tw ) XpTableWidget tw; { int width, height, bw, x, y; XpTableLoc loc = tw->table.real_layout; while ( loc->w && loc->w != tw->table.resize_child ) ++loc; if ( loc->w != tw->table.resize_child ) { String args[3]; Cardinal two = 2; args[0] = XtName(tw->table.resize_child); args[1] = XtName((Widget)tw); args[2] = NULL; XtWarningMsg( "unmanagedChildMadeResizeRequest", "XpTableGetProposedChildSize", "Xt Implementation Bug", "XtMakeGeometryRequest passed request from unmanaged child %s to table %s\n", args, &two ); XpTableForgetProposedLayout( tw ); return; } /* This loc is for the child requesting the resize. * * First, try to use all the dimensions: width, height, requested border. * If the width and height are not minimums, we are done. */ width = height = 0; /* need to compute these */ bw = tw->table.resize_border_width; /* assume we grant this */ XpTableComputeChildSize( tw, loc, &width, &height, &bw, &x, &y ); if ( 1 < width && 1 < height ) { XpTableApproveGeometryChanges( tw, loc->w, width, height, bw ); return; } /* Try again, this time using the current border width */ width = height = 0; bw = loc->w->core.border_width; XpTableComputeChildSize( tw, loc, &width, &height, &bw, &x, &y ); if ( width < 1 ) width = 1; if ( height < 1 ) height = 1; XpTableApproveGeometryChanges( tw, loc->w, width, height, bw ); } void XpTableApproveGeometryChanges( tw, child, width, height, bw ) XpTableWidget tw; Widget child; int width, height, bw; { tw->table.approved_child = child; tw->table.approved_mode = (XtGeometryMask)0; if ( tw->table.resize_mode&CWBorderWidth && bw != child->core.border_width ) tw->table.approved_mode |= CWBorderWidth; if ( tw->table.resize_mode&CWWidth && width != child->core.width ) tw->table.approved_mode |= CWWidth; if ( tw->table.resize_mode&CWHeight && height != child->core.height ) tw->table.approved_mode |= CWHeight; tw->table.approved_border_width = bw; tw->table.approved_width = width; tw->table.approved_height = height; } /* Set Geometry Of Children **==========================** Children are placed according to the real_layout, cols, rows, and row and column spacing. */ void XpTableSetGeometryOfChildren( tw ) XpTableWidget tw; { XpTableLoc loc; if ( tw->table.real_layout == (XpTableLoc)0 || tw->table.cols == (XpTableVector)0 || tw->table.num_cols == 0 || tw->table.rows == (XpTableVector)0 || tw->table.num_rows == 0 ) return; XpTableVectorComputeOffsets( tw->table.cols, tw->table.num_cols, tw->table.margin_width, tw->table.col_spacing ); XpTableVectorComputeOffsets( tw->table.rows, tw->table.num_rows, tw->table.margin_height, tw->table.row_spacing ); for ( loc = tw->table.real_layout ; loc->w ; loc++ ) { int width, height, bw, x, y; /* This can be invoked due to a child size change request, in which * case the child has not yet been changed in size, but this size * has been guaranteed to be OK. */ if ( loc->w == tw->table.approved_child ) { width = tw->table.approved_width; height = tw->table.approved_height; bw = tw->table.approved_border_width; } else { width = 0; height = 0; bw = loc->w->core.border_width; } XpTableComputeChildSize( tw, loc, &width, &height, &bw, &x, &y ); if ( width != loc->w->core.width || height != loc->w->core.height || bw != loc->w->core.border_width ) XtResizeWidget( loc->w, width, height, bw ); if ( x != loc->w->core.x || y != loc->w->core.y ) XtMoveWidget( loc->w, x, y ); } } void XpTableComputeChildSize( tw, loc, wP, hP, bwP, xP, yP ) XpTableWidget tw; XpTableLoc loc; int *wP, *hP; /* in-out, USE if != 0 */ int *bwP; /* in */ int *xP, *yP; /* out */ { int cell_x, cell_y, cell_w, cell_h; int new_x, new_y, new_w, new_h, prefer; int total_w, total_h; int pad, i; int init_w = *wP; /* non-zero means use it */ int init_h = *hP; /* non-zero means use it */ int bw = *bwP; /* Upper left corner of where we will place the widget */ cell_x = tw->table.cols[ loc->col ].offset; cell_y = tw->table.rows[ loc->row ].offset; /* cell width and height may well span cols and rows and spacing */ pad = tw->table.col_spacing; cell_w = -pad; for ( i = 0 ; i < loc->col_span ; i++ ) cell_w += tw->table.cols[ loc->col + i ].value + pad; pad = tw->table.row_spacing; cell_h = -pad; for ( i = 0 ; i < loc->row_span ; i++ ) cell_h += tw->table.rows[ loc->row + i ].value + pad; /* If the width or height was given, then use it. This given dimension * has already been approved by the table in geometry negotiation (by * the GeometryManager method). * * Otherwise, If size growth is prevented due to TBL_SM_(WIDTH | HEIGHT), * then use the lesser of the cell size or the preferred size. * * Otherwise, use the cell size. */ if (init_w) { new_w = init_w; } else if (loc->options & TBL_SM_WIDTH && cell_w > (prefer = XpTableLocPreferredWidth( loc, tw )) ) { new_w = prefer - 2 * bw; } else { new_w = cell_w - 2 * bw; } if (init_h) { new_h = init_h; } else if (loc->options & TBL_SM_HEIGHT && cell_h > (prefer = XpTableLocPreferredHeight( loc, tw )) ) { new_h = prefer - 2 * bw; } else { new_h = cell_h - 2 * bw; } /* Be certain that the size does not go to zero, or negative! */ if ( new_w <= 0 ) new_w = 1; /* value ready for XtResize */ if ( new_h <= 0 ) new_h = 1; /* value ready for XtResize */ total_w = new_w + 2 * bw; total_h = new_h + 2 * bw; if ( loc->options & TBL_LEFT ) new_x = cell_x; /* left justify in cell */ else if ( loc->options & TBL_RIGHT ) new_x = cell_x + cell_w - total_w; /* right justify in cell */ else new_x = cell_x + (cell_w - total_w)/2; /* center in cell */ if ( loc->options & TBL_TOP ) new_y = cell_y; /* top justify in cell */ else if ( loc->options & TBL_BOTTOM ) new_y = cell_y + cell_h - total_h; /* bottom justify in cell */ else new_y = cell_y + (cell_h - new_h)/2; /* center in cell */ *wP = new_w; *hP = new_h; *xP = new_x; *yP = new_y; } /* TableOpts methods **===================** */ XpTableOpts XpTableOptsParse( optString ) String optString; { XpTableOpts opt = 0; for ( ; *optString; optString++) { switch (*optString) { case 'l': opt |= TBL_LEFT; break; case 'r': opt |= TBL_RIGHT; break; case 't': opt |= TBL_TOP; break; case 'b': opt |= TBL_BOTTOM; break; case 'w': opt |= TBL_LK_WIDTH; break; case 'h': opt |= TBL_LK_HEIGHT; break; case 'W': opt |= TBL_SM_WIDTH; break; case 'H': opt |= TBL_SM_HEIGHT; default: break; } } return opt; } /* Client Utility Functions **==========================** The following functions are used to reconfigure children of Table widgets */ /* Position Child in Col,Row of Table **====================================** */ #define CHG_POS 0x1 #define CHG_SPAN 0x2 #define CHG_OPTS 0x4 #define CHG_ALL 0x7 static void Change( loc, what, col, row, col_span, row_span, opts ) XpTableLoc loc; /* specific loc to change */ int what; /* What to change */ int col, row; /* New position in table */ int col_span, row_span; /* New spans of child in table */ XpTableOpts opts; /* New size/justification opts */ { if ( what & CHG_POS ) { if ( 0 <= col ) loc->col = col; if ( 0 <= row ) loc->row = row; } if ( what & CHG_SPAN ) { if ( 1 <= col_span ) loc->col_span = col_span; if ( 1 <= row_span ) loc->row_span = row_span; } if ( what & CHG_OPTS ) { loc->options = opts; } } static void XpTableChildChange( child, what, col, row, col_span, row_span, opts) Widget child; /* Child widget to change */ int what; /* What to change */ int col, row; /* New position in table */ int col_span, row_span; /* New spans of child in table */ XpTableOpts opts; /* New size/justification opts */ { if ( !XpIsTable( child->core.parent ) ) { Cardinal one = 1; char* name = XtName( child ); XtWarningMsg( "notChildOfTable", "XpTableChildChange", "XpLibError", "Widget %s is not a child of an XpTable widget.", &name, &one); return; } else { XpTableWidget tw = (XpTableWidget)child->core.parent; XpTableLoc def = XpTableLocFind( tw->table.default_layout,child); XpTableLoc real = XpTableLocFind( tw->table.real_layout, child); if ( def == (XpTableLoc)0 ) { /* Never laid out this child before. */ static XpTableLocRec nullRec; XpTableLocRec newRec; XpTableLoc initDef; newRec = nullRec; def = &newRec; /* Find the initial default for this name, copy what we can. */ initDef = XpTableLocFindDefault( tw->table.default_layout, child ); if ( initDef != (XpTableLoc)0 ) *def = *initDef; /* Set up default fields. */ def->w_quark = child->core.xrm_name; def->w = child; if ( def->col_span <= 0 ) def->col_span = 1; if ( def->row_span <= 0 ) def->row_span = 1; if ( def->options == 0 ) def->options = tw->table.default_options; def->orig_width = child->core.width; def->orig_height = child->core.height; def->orig_border_width = child->core.border_width; /* Append to default_layout, then get pointer to that loc */ XpTableAppendToDefaultLayout( tw, def ); def = XpTableLocFind( tw->table.default_layout,child ); } /* Change loc in default_layout to reflect widget position etc. */ Change( def, what, col, row, col_span, row_span, opts ); if ( real != (XpTableLoc)0 ) { /* In real_layout: Change child's actual position/span/opt */ Change( real, what, col, row, col_span, row_span, opts ); /* We do not have to create a new real_layout. Also, we know ** child is managed, since it is in the real_layout. Therefore: */ XpTableRecomputeLayout( tw ); } /* If the child is not managed, no re-layout needs to be done: it ** will be done when the child becomes managed (see ChangeManaged) */ } } /* Change Position of Child **==========================** */ void XpTableChildPosition( child, col, row ) Widget child; /* Child widget to move */ int col, row; /* New position in table */ { XpTableChildChange( child, CHG_POS, col, row, 0, 0, 0); } /* Change Size (Span) of Child **=============================** */ void XpTableChildResize( child, col_span, row_span) Widget child; /* Child widget to resize */ int col_span, row_span; /* New widget span */ { XpTableChildChange( child, CHG_SPAN, 0, 0, col_span, row_span, 0); } void XpTableChildOptions( child, opts ) Widget child; /* Child widget to get new options */ XpTableOpts opts; /* New option mask */ { XpTableChildChange( child, CHG_OPTS, 0, 0, 0, 0, opts ); } void XpTableChildConfig( child, col, row, col_span, row_span, opts ) Widget child; /* Child widget to change */ int col, row; /* New position in table */ int col_span, row_span; /* New spans of child in table */ XpTableOpts opts; /* New size/justification opts */ { XpTableChildChange( child, CHG_ALL , col, row, col_span, row_span, opts); } /* Constructors **==============** */ Widget XpCreateTable( parent, name, arglist, argcount ) Widget parent; char* name; ArgList arglist; Cardinal argcount; { return XtCreateWidget(name, xpTableWidgetClass, parent, arglist, argcount); } /* Table Dialog Constructor ** Date: Fri, 8 Feb 91 12:23:39 EST ** From: pastor@PRC.Unisys.COM (Jon A. Pastor) */ #ifndef DIALOG_SUFFIX #define DIALOG_SUFFIX "_popup" #define DIALOG_SUFFIX_SIZE strlen(DIALOG_SUFFIX) #endif /* Destroy parent dialog shell when the child is destroyed. */ /*ARGSUSED*/ static void XpDestroyParentCallback( w, ignored, unused ) Widget w; XtPointer ignored, unused; { XtDestroyWidget( XtParent( w ) ); } Widget XpCreateTableDialog( parent, name, arglist, argcount ) Widget parent; char* name; ArgList arglist; Cardinal argcount; { return XpCreateTableTransient( parent, name, arglist, argcount ); } Widget XpCreateTableTransient( parent, name, arglist, argcount ) Widget parent; char* name; ArgList arglist; Cardinal argcount; { char* dsName; int i; Arg shellArgs[2]; Widget tableShell, table; /* Fabricate a name for the dialog shell using Motif 1.1 naming */ dsName = (char*)XtCalloc( strlen(name)+DIALOG_SUFFIX_SIZE+1, sizeof(char) ); strcpy( dsName, name ); strcat( dsName, DIALOG_SUFFIX ); /* Create a Transient Shell widget */ i = 0; XtSetArg( shellArgs[i], XtNallowShellResize, True); i++; #ifdef XtTransientForBugIsFixed #ifdef XtSpecificationRelease XtSetArg( shellArgs[i], XtNtransientFor, parent); i++; #endif #endif tableShell = XtCreatePopupShell( dsName, transientShellWidgetClass, parent, shellArgs, i ); XtFree( dsName ); /* Create the Table widget */ table = XtCreateWidget( name, xpTableWidgetClass, tableShell, arglist, argcount ); XtManageChild( table ); XtAddCallback( table, XtNdestroyCallback, XpDestroyParentCallback, (XtPointer)0 ); return table; }