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

Art Text 3.2.3 - $49.99
Art Text is graphic design software specifically tuned for lettering, typography, text mockups and various artistic text effects. Supplied with a great variety of ready to use styles and materials,... Read more
RapidWeaver 7.5.1 - Create template-base...
RapidWeaver is a next-generation Web design application to help you easily create professional-looking Web sites in minutes. No knowledge of complex code is required, RapidWeaver will take care of... Read more
PDFKey Pro 4.3.9 - Edit and print passwo...
PDFKey Pro can unlock PDF documents protected for printing and copying when you've forgotten your password. It can now also protect your PDF files with a password to prevent unauthorized access and/... Read more
ClamXav 2.15.2 - Virus checker based on...
ClamXav is a popular virus checker for OS X. I have been working on ClamXav for more than 10 years now, and over those years, I have invested a huge amount of my own time and energy into bringing... Read more
TechTool Pro 9.5.3 - Hard drive and syst...
TechTool Pro has long been one of the foremost utilities for keeping your Mac running smoothly and efficiently. With the release of version 9, it has become more proficient than ever. TechTool... Read more
Safari Technology Preview 11.1 - The new...
Safari Technology Preview contains the most recent additions and improvements to WebKit and the latest advances in Safari web technologies. And once installed, you will receive notifications of... Read more
Google Chrome 61.0.3163.91 - Modern and...
Google Chrome is a Web browser by Google, created to be a modern platform for Web pages and applications. It utilizes very fast loading of Web pages and has a V8 engine, which is a custom built... Read more
Dropbox 35.4.20 - Cloud backup and synch...
Dropbox is an application that creates a special Finder folder that automatically syncs online and between your computers. It allows you to both backup files and keep them up-to-date between systems... Read more
GraphicConverter 10.5 - $39.95
GraphicConverter is an all-purpose image-editing program that can import 200 different graphic-based formats, edit the image, and export it to any of 80 available file formats. The high-end editing... Read more
Chromium 61.0.3163.91 - Fast and stable...
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all Internet users to experience the web. Version 61.0.3163.91: Release notes were unavailable... Read more

Stormbound: Kingdom Wars guide - how to...
Stormbound: Kingdom Wars is an excellent new RTS turned card battler out now on iOS and Android. Lovers of strategy will get a lot of enjoyment out of Stormbound's chess-like mechanics, and it's cardbased units are perfect for anyone who loves the... | Read more »
The best AR apps and games on iOS right...
iOS 11 has officially launched, and with it comes Apple's ARKit, a helpful framework that makes it easier than ever for developers to create mobile AR experiences. To celebrate the occassion, we're featuring some of the best AR apps and games on... | Read more »
Phoenix Wright: Ace Attorney - Spirit of...
Phoenix Wright: Ace Attorney - Spirit of Justice 1.00.00 Device: iOS Universal Category: Games Price: $.99, Version: 1.00.00 (iTunes) Description: ************************************************※IMPORTANT※・Please read the “When... | Read more »
Kpressor (Utilities)
Kpressor 1.0.0 Device: iOS Universal Category: Utilities Price: $4.99, Version: 1.0.0 (iTunes) Description: The ultimate ZIP compression application for iPhone and iPad. - Full integration of iOS 11 with support for multitasking.-... | Read more »
Find out how you can save £35 and win a...
Nothing raises excitement like a good competition, and we’re thrilled to announce our latest contest. We’ll be sending one lucky reader and a friend to the Summoners War World Arena Championship at Le Comedia in Paris on October 7th. It’s the... | Read more »
Another Lost Phone: Laura's Story...
Another Lost Phone: Laura's Story 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Another Lost Phone is a game about exploring the social life of a young woman whose phone you have just... | Read more »
The Witness (Games)
The Witness 1.0 Device: iOS Universal Category: Games Price: $9.99, Version: 1.0 (iTunes) Description: You wake up, alone, on a strange island full of puzzles that will challenge and surprise you. You don't remember who you are, and... | Read more »
Egg, Inc. guide - how to build your gold...
Egg, Inc.'s been around for some time now, but don't you believe for one second that this quirky clicker game has gone out of style. The game keeps popping up on Reddit and other community forums thanks to the outlandish gameplay (plus, the... | Read more »
The best deals on the App Store this wee...
Good news, everyone! Your favorite day of the week has arrived at last -- it's discount roundup day! This fine Wednesday evening we're gathering up the hottest deals on the App Store. We've got action platformers, we've got puzzle games, we've got... | Read more »
Morphite (Games)
Morphite 1.08 Device: iOS Universal Category: Games Price: $7.99, Version: 1.08 (iTunes) Description: | Read more »

Price Scanner via MacPrices.net

OWC USB-C Travel Dock with 5 Ports Connectivi...
OWC have announced the new OWC USB-C Travel Dock, the latest addition to their line of connectivity solutions. The USB-C Travel Dock lets you connect its integrated USB-C cable to a Mac or PC laptop... Read more
Pelican Products, Inc. Unveils Cases For All...
Pelican Products, Inc. has announced the launch of its full line of cases including Voyager, Adventurer, Protector, Ambassador, Interceptor (for the Apple iPhone 8 and 8 Plus backwards compatible... Read more
$100 off new 2017 13-inch MacBook Airs
B&H Photo has 2017 13″ MacBook Airs on sale today for $100 off MSRP including free shipping. B&H charges NY & NJ sales tax only: – 13″ 1.8GHz/128GB MacBook Air (MQD32LL/A): $899, $100 off... Read more
Apple restocks Certified Refurbished 13-inch...
Apple has Certified Refurbished 2015 13″ MacBook Airs available starting at $719 and 2016 models available starting at $809. An Apple one-year warranty is included with each MacBook, and shipping is... Read more
Is iPhone X Really The Future Of The Smartpho...
Should iPhone X even be called a telephone? It does of course support telephony and texting, but its main feature set is oriented to other things. It is also debatable whether it makes any rational... Read more
OtterBox Announces Full Case Lineup for iPhon...
Apple revolutionized the smartphone industry 10 years ago with the original iPhone, and OtterBox has set the standard of protection from the very beginning by protecting every generation of iPhone.... Read more
LifeProof Introduces What’s NEXT Cases for iP...
LifeProof built its reputation on sleek, ultra-protective iPhone cases. From 360-degree coverage to the first screenless waterproof case, the protection pioneer has always pushed the limits.... Read more
Apple Refurbished 2016 15-inch MacBook Pros a...
Apple has Certified Refurbished 2016 15″ Touch Bar MacBook Pros available starting at $1949. An Apple one-year warranty is included with each model, and shipping is free: – 15″ 2.7GHz Touch Bar Space... Read more
Wednesday deal: 15-inch MacBook Pros for up t...
B&H Photo has 2017 15″ MacBook Pros on sale for $150-$200 off MSRP. Shipping is free, and B&H charges sales tax in NY & NJ only: – 15″ 2.8GHz MacBook Pro Space Gray: $2199, $200 off MSRP... Read more
2.6GHz Mac mini on sale for $599, $100 off MS...
B&H Photo has the 2.6GHz Mac mini (MGEN2LL/A) on sale for $599 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Read more

Jobs Board

Development Operations and Site Reliability E...
Development Operations and Site Reliability Engineer, Apple Payment Gateway Job Number: 57572631 Santa Clara Valley, California, United States Posted: Jul. 27, 2017 Read more
Full time *Apple* Hardware Tech needed - ma...
…high level of attention to detail Ethics, integrity and trust Be a geek & Previous Apple experience a must. Previous Apple Retail or other Apple Specialist Read more
Development Operations and Site Reliability E...
Development Operations and Site Reliability Engineer, Apple Payment Gateway Job Number: 57572631 Santa Clara Valley, California, United States Posted: Jul. 27, 2017 Read more
*Apple* Store - Technical Specialist - Apple...
…customers purchase our products, you're the one who helps them get more out of their new Apple technology. Your day in the Apple Store is filled with a range of Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.