MacApp 2.0b5 UGridView Release Notes

( MacApp® 2.0bS UGridView Release Notes Deb Orton Overview The purpose of the UGridView module is to provide the view that goes "on top" of a list or grid framework. UGridView knows nothing about the underlying cell contents (with the exception of the text methods which work for text grids or lists only); therefore, the user must (at least) provide a DrawCell method (or a GetText method in the TextView cases). The height and width of rows and columns are variable although optimized for a fixed value. The standard cell selection algorithms are provided (as described by the List Manager in Inside Macintosh. Volume IV), as well as a method for enabling single cell selection only. Selection through a method call is provided. View templates exist for all the view objects in this unit. The following classes are defined in UGridView: TGridView For displaying a 1- or 2-dimensional grid of cells containing anything (text, picts, subviews, and so on). TTextGridView For displaying a 1- or 2-dimensional grid of cells containing only text. TTextListView For displaying a I-dimensional grid of cells containing only text. TGridSelectCommand For building the other command objects. TCellSelectCommand For selecting a cell. TRowSelectComrnand For selecting a row divider. TColSelectComrnand For selecting a column divider. TVertexSelectComrnand For selecting a row and column divider. Wed, Aug 3, 1988 © 1988 ti Apple Computer, Inc. 1 TGridView Types GridCell = Point; A cell in the grid. GridViewPart = (badChoice, inCell, inRow, inColumn, inVertex); Used to type mouse clicks. RunArrayChunk RunArray contents (private). RECORD count: size: INTEGER; INTEGER; END; RunArray =ARRAY [0 .. 100000] OF RunArrayChunk; For casting use (private). PRunArray "RunArray; Pointer to run array (private). HRunArray "PRunArray; A handle to a run array (private). Template Types GridViewTemplate PACKED RECORD numOfRows: INTEGER; numOfCols: INTEGER; rowHeight: INTEGER; colWidth: INTEGER; rowinset: INTEGER; colinset: INTEGER; adornRows: BOOLEAN; adornCols: BOOLEAN; singleSelection: BOOLEAN; filler: 0 .. 8191; END; GridViewTemplatePtr = "GridViewTemplate; TextGridViewTemplate itsFontFace: itsFontSize: itsFontColor: itsFontName: END; PACKED RECORD Style; INTEGER; RGBColor; Str255; TextGridViewTemplatePtr Wed, Aug 3, 1988 "TextGridViewTemplate; © 1988 4i Apple Computer, Inc. () 2 Constants ( Template identifiers for views defined in this unit: 'TGridView'; kGridView = 'TTextGridView'; kTextGridView 'TTextListView' ; kTextListView For setting column/row width/height in only one row/column: 1; kOneRow 1; kOneCol = Select Command Identifiers: cCellSelect = cRowSelect = cColumnSelect cVertexSelect 1; 2; 3; 4; Booleans for SetSelection: kExtend = kDontExtend = kHighlight = kDontHighlight kSelect = kDeSelect TRUE; FALSE; TRUE; FALSE; TRUE; FALSE; Booleans for CreateHighlightRgn: kWholeRect = kNotWholeRect = TRUE; FALSE; Fields fnumOfRows: fnumOfCols…