TweetFollow Us on Twitter

January 94 - Using TGridView

Using TGridView

Bob Hablutzel

This is the second article in what will hopefully be a monthly series of technical question and answers on object oriented programming. The intent of this column is to go beyond simple answers. I intend to take a question, answer it, and then use that question as a springboard to a more general discussion on programming. I hope you find the results interesting.

The first articles will be culled from frequently asked questions on MacApp3Tech$, but I need your questions! I can be reached electronically at AppleLink: B.HABLUTZEL; by telephone at 708.328.0130; by fax at 708.328.2417 or by post at Bob Hablutzel, Hablutzel Consulting, 606 Asbury, Evanston, IL, USA 60202.

QI would like to display a list of strings. MacApp seems to have a class for doing just this (TTextListView), but I cannot figure out how to attach the TList to it. How is the list associated with the view?

AThe immediate answer is that the list in TList and the list in TTextListView are not the same list. Unfortunately, it appears from the names of the classes that they were designed to go together. While they do work nicely together, it is not as transparent as the names would imply.

To understand the problem, we need to take a step back and look at the overall view hierarchy. In general, the view classes are fully functional; you can instantiate them, and they will perform the actions you expect. The classes in the category include TView, TButton, TRadio, etc.

A few of the view classes, however, are really abstract superclasses, and are not meant to be instantiated. TGridView, TTextGridView, and TTextListView all fall into this category. They are there for you to customize, not for you to use as–is. Another important fact to realize is that the classes, unlike the toolbox List Manager, do not maintain the data for you; this is something you need to maintain in the subclass you create.

TGridView, the parent of these views, describes a basic cell-oriented view. It knows a great deal about displaying cell oriented data: how to select cells, how to scroll cells, managing different column widths and row heights. It explicitly does not, however, know how to draw any particular cell.

This makes some sense, from a framework perspective. There is really no way to predict what kind of cell you will be imaging, and therefore it makes sense to make no assumptions. This leaves the doors open to icon cells, text cells, numeric cells, or even a mixed bag of all of these.

What TGridView does define, however, is a routine that is called to draw a particular cell. This routine, TGridView::DrawCell(), takes two arguments. The first argument defines which cell is being imaged. The cell is passed as a point–like structure defining the column and row numbers of the cell. The second argument is the rectangle to draw into.

If you decide to implement a view based on TGridView, you need to override DrawCell. (You may not need to override any other method). In the DrawCell override, you would determine the data you are going to image (based on the column and row numbers passed in), and draw the data. Again, this data can be anything you choose; you are in complete control of the drawing.

The designers of MacApp realized, however, that text-only grids are very common and important grid types. In order to make it easier to support these grid types, they created the TTextGridView and TTextListView classes. In these classes, a text-only override of DrawCell has already been provided for you, and you therefore do not have to worry about the imaging of the data. You do, however, need to provide a means of obtaining the data.

TTextGridView defines a view that understands multiple–column grids of text. It defines a routine, GetText(), that takes two arguments. The first argument is the cell to return text for, and the second is the text being returned. By default, this routine returns an empty string, so if you include an unspecialized TTextGridView in your programs, you will have the right number of cells, but nothing in them. You need to provide an override to GetText to provide the text for the individual cells.

TTextListView defines a view that is subclassed from TTextGridView, and is specialized to handle single–column grids of text. It overrides the default definition of GetText, and in turns calls a more specialized TTextListView defined routine, GetItemText. This routine takes two arguments, much like TTextGridView::GetText, but the first argument is simply the row number, not the cell. This allows you to return the string based on row number only.1

If you subclass either of TTextGridView or TTextListView, you need to at least override GetText or GetItemText, respectively. This give the view some text to draw. Of course, you need to get the text from somewhere. You basically have three choices: calculate the data on the fly; store the data in the view; or store the data extermally to the view, most likely in a document. The override of GetText/GetItemText needs to know how to obtain the text given the cell/row number.

We have talked about displaying the data contained in a grid view, but there is another problem to be solved: defining the number of rows and columns. For some applications, this value can be pre-determined, and coded into your view creation (or set with your favorite view editor). However, for most applications the size of the grid needs to be determined at run time. TGridView provides a number of useful routines for handling this problem, such as InsRowFirst to insert rows, InsColFirst to insert columns, DelRowFirst to delete rows, and DelColFirst to delete columns.

Take, for example, the method TGridView::InsRowFirst. This routine creates a new row of cells for data to be displayed in at the beginning of the grid. Since grid views do not know about data, it has no way of affecting the data that corresponds to these cells. It is your responsibility to manipulate the data to correspond to the new cell state. (More properly, it is your responsibility to call this routines to manipulate the grid to correspond to changes in the data's state.) The changing of the data, and the changing of the display of the data, are two separate actions that need to take place simultaneously. (This is also true for the routines that TTextListView defines, such as InsItemFirst.)

It is important to stress that these routines manipulate cells, not data. By adding or deleting cells, you provide room for data to be displayed; you do not affect data in any way. It is worth noting at this point that, if your grid view changes size and lives in a scroller, you probably want to change the size determiner of the view to sizeVariable. If you don't, the view will not really change size when you add or delete rows, confusing the scroller.

There are a number of tricks you can use to make your life easier when managing the number of cells. For example, you could make the grid view object dependent upon the document it is associated with. Then, when the document data changes, the grid view can catch the change in an override of DoUpdate, and adjust the number of cells accordingly. Grid views provide a simple means of display cell-oriented data. You need to remember that it is your responsibility to define a means for them to obtain the data, and, in the case of direct TGridView subclasses, to display the data. You also need to tell the grid how large it is, so that it can display the right number of cells for your data. Forgetting either of these two actions will result in no data being displayed in the view.

1 This might seem like a trivial reason for an override, and by itself it would be. However, TTextListView also provides some functionality, such as type-selection, that make sense for single column grids but not for multiple–column grids.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

djay Pro 1.1 - Transform your Mac into a...
djay Pro provides a complete toolkit for performing DJs. Its unique modern interface is built around a sophisticated integration with iTunes and Spotify, giving you instant access to millions of... Read more
Vivaldi 1.0.118.19 - Lightweight browser...
Vivaldi browser. In 1994, two programmers started working on a web browser. Our idea was to make a really fast browser, capable of running on limited hardware, keeping in mind that users are... Read more
Stacks 2.6.11 - New way to create pages...
Stacks is a new way to create pages in RapidWeaver. It's a plugin designed to combine drag-and-drop simplicity with the power of fluid layout. Features: Fluid Layout: Stacks lets you build pages... Read more
xScope 4.1.3 - Onscreen graphic measurem...
xScope is powerful set of tools that are ideal for measuring, inspecting, and testing on-screen graphics and layouts. Its tools float above your desktop windows and can be accessed via a toolbar,... Read more
Cyberduck 4.7 - FTP and SFTP browser. (F...
Cyberduck is a robust FTP/FTP-TLS/SFTP browser for the Mac whose lack of visual clutter and cleverly intuitive features make it easy to use. Support for external editors and system technologies such... Read more
Labels & Addresses 1.7 - Powerful la...
Labels & Addresses is a home and office tool for printing all sorts of labels, envelopes, inventory labels, and price tags. Merge-printing capability makes the program a great tool for holiday... Read more
teleport 1.2.1 - Use one mouse/keyboard...
teleport is a simple utility to let you use one single mouse and keyboard to control several of your Macs. Simply reach the edge of your screen, and your mouse teleports to your other Mac! The... Read more
Apple iMovie 10.0.8 - Edit personal vide...
With an all-new design, Apple iMovie lets you enjoy your videos like never before. Browse your clips more easily, instantly share your favorite moments, and create beautiful HD movies and Hollywood-... Read more
Box Sync 4.0.6233 - Online synchronizati...
Box Sync gives you a hard-drive in the Cloud for online storage. Note: You must first sign up to use Box. What if the files you need are on your laptop -- but you're on the road with your iPhone? No... Read more
Fantastical 2.0.3 - Create calendar even...
Fantastical 2 is the Mac calendar you'll actually enjoy using. Creating an event with Fantastical is quick, easy, and fun: Open Fantastical with a single click or keystroke Type in your event... Read more

SoundHound + LiveLyrics is Making its De...
SoundHound Inc. has announced that SoundHound + LiveLyrics, will be one of the first third-party apps to hit the Apple Watch. With  SoundHound you'll be able to tap on your watch and have the app recognize the music you are listening to, then have... | Read more »
Adobe Joins the Apple Watch Lineup With...
A whole tidal wave of apps are headed for the Apple Watch, and Adobe has joined in with 3 new ways to enhance your creativity and collaborate with others. The watch apps pair with iPad/iPhone apps to give you total control over your Adobe projects... | Read more »
Z Steel Soldiers, Sequel to Kavcom'...
Kavcom has released Z Steel Soldiers, which continues the story of the comedic RTS originally created by the Bitmap Brothers. [Read more] | Read more »
Seene Lets You Create 3D Images With You...
Seene, by Obvious Engineering, is a 3D capture app that's meant to allow you to create visually stunning 3D images with a tap of your finger, and then share them as a 3D photo, video or gif. [Read more] | Read more »
Lost Within - Tips, Tricks, and Strategi...
Have you just downloaded Lost Within and are you in need of a guiding hand? While it’s not the toughest of games out there you might still want some helpful tips to get you started. [Read more] | Read more »
Entertain Your Pet With Your Watch With...
The Petcube Camera is a device that lets you use live video to check in on your pet, talk to them, and play with them using a laser pointer - all while you're away. And the Petcube app is coming to the Apple Watch, so you'll be able to hang out with... | Read more »
Now You Can Manage Your Line2 Calls With...
You'll be able to get your Line2 cloud phone service on the Apple Watch very soon. The watch app can send and receive messages using hands-free voice dictation, or by selecting from a list of provided responses. [Read more] | Read more »
R.B.I. Baseball 15 (Games)
R.B.I. Baseball 15 1.01 Device: iOS Universal Category: Games Price: $4.99, Version: 1.01 (iTunes) Description: The legendary Major League Baseball franchise returns to the diamond. Make History. ** ALL iPOD Touch, the iPad 2 and the... | Read more »
Here's How You Can Tell if an App W...
The Apple Watch is pretty much here, and that means a whole lot of compatible apps and games are going to be updated or released onto the App Store. That's okay though, beacause Apple has quietly updated their app description pages to make things... | Read more »
Forgotten Memories : Alternate Realities...
Forgotten Memories : Alternate Realities 1.0.1 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.1 (iTunes) Description: + REDUCED PRICE ONLY THE LAUNCHING WEEK + "The most exciting horror game of 2015." - AppSpy... | Read more »

Price Scanner via MacPrices.net

Intel Compute Stick: A New Mini-Computing For...
The Intel Compute Stick, a new pocket-sized computer based on a quad-core Intel Atom processor running Windows 8.1 with Bing, is available now through Intel Authorized Dealers across much of the... Read more
Heal to Launch First One-Touch House Call Doc...
Santa Monica, California based Heal, a pioneer in on-demand personal health care services — will offer the first one-touch, on-demand house call doctor app for the Apple Watch. Heal’s Watch app,... Read more
Mac Notebooks: Avoiding MagSafe Power Adapter...
Apple Support says proper usage, care, and maintenance of Your Mac notebook’s MagSafe power adapter can substantially increase the the adapter’s service life. Of course, MagSafe itself is an Apple... Read more
12″ Retina MacBook In Shootout With Air And P...
BareFeats’ rob-ART morgan has posted another comparison of the 12″ MacBook with other Mac laptops, noting that the general goodness of all Mac laptops can make which one to purchase a tough decision... Read more
FileMaker Go for iPad and iPhone: Over 1.5 Mi...
FileMaker has announced that its FileMaker Go for iPad and iPhone app has surpassed 1.5 million downloads from the iTunes App Store. The milestone confirms the continued popularity of the FileMaker... Read more
Sale! 13-inch 2.7GHz Retina MacBook Pro for $...
 Best Buy has the new 2015 13″ 2.7GHz/128GB Retina MacBook Pro on sale for $1099 – $200 off MSRP. Choose free shipping or free local store pickup (if available). Price for online orders only, in-... Read more
Minimalist MacBook Confirms Death of Steve Jo...
ReadWrite’s Adriana Lee has posted a eulogy for the “Digital Hub” concept Steve Jobs first proposed back in 2001, declaring the new 12-inch MacBook with its single, over-subscribed USB-C port to be... Read more
13-inch 2.7GHz Retina MacBook Pro for $1234 w...
Adorama has the 13″ 2.7GHz/128GB Retina MacBook Pro in stock for $1234.99 ($65 off MSRP) including free shipping plus a free LG external DVD/CD optical drive. Adorama charges sales tax in NY & NJ... Read more
13-inch 2.5GHz MacBook Pro available for $999...
 Adorama has the 13-inch 2.5GHz MacBook Pro on sale for $999 including free shipping plus NY & NJ sales tax only. Their price is $100 off MSRP. Read more
Save up to $600 with Apple refurbished Mac Pr...
The Apple Store is offering Apple Certified Refurbished Mac Pros for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Service-Learning Counselor, *APPLE* Corps -...
…CONTRACT TITLE Higher Education Assistant FLSA Exempt CAMPUS SPECIFIC INFORMATION APPLE Corps (Academic Preparation Program for Law Enforcement), a partnership between Read more
*Apple* iOS Specialist - Kforce (United Stat...
Our client is seeking an Apple iOS Specialist to join their team in Quincy, Massachusetts (MA). Duties: * Responsible for configuration and distribution of desktop, Read more
*Apple* Systems Engineer - Axius Technologie...
* Must be Apple -Certified specialist and will be responsible for all hardware: device settings, images creation/deployment, security implementation * Responsible for all Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.