variable tecper1rnentIrQ 00 the baSis of tills oo,l,an To ln1l1ement

e)CI)8r1mental features,

sln1l1y

surnulCJ COde de811ng with tnose features with a test on _ When you CheCk off thls Item In the merlI, that

van.able Is TRl£, ald your provisional COde Is e~ted. BecaI.se the

detUJ

Usa TooJKIl RehutJnce H8nJ8J TooJKIl Dea.gJer

menJS do. not ~ In ron-detlJg verslO'lS of ToolKit progl~ your

experimental

code C8'l

never

be

executed In

ron-detlJg

versions

Of your PlOQJam.

When this optloo Is In effect, It Is checked off In the debJg meru. To disable this ~tlon, choose the meru Item a seco ld t1me.

5.2.7 Report GaItlage In Doa.ment Help

When you choose tnls ~Uoo, the deDlJger prints lnformaUon aboUt oojects In the oocunent

neap

to Whlcn

hlr are ro

^refelel ICeS. The information printed

consists Of the Object's r&ldle a'ld Class-type ... To determlne what COIIII80

caJSed

tile problem, tree tile garbage by us~ tile·

Free

^Garbage In DoCl.ment Heap option, a'ld tty out various application co ^I mn2S. InVOke the Report.

Garbage In DoCl.ment Heap option after ecDl amlaK1 5.2..8 Free

GataJe

^In DoaIYBlt. Haap

When you choose tnls optlal, the detJUgger frees

an

^{oojects In the docu1lent}

neap

to WhICh tnere are no refeJeI

.ces.

The oojects freed are the sane ones

that WOUld be Indicated by Report GaItIIge In DoaIYBlt. HBBp.

T1l1s COOI.am

only

acts orr::e. To

flee garbage

later"

choose

tre opUoo

again.

-~9 Edit DIalog ' ..

This ft.rotloo Is only er&lled When

ere

of your 8A)llcation's dialog bOXeS Is displayed and the cumnt selection Is in tile dialog bOx. When you choose

tills

^{COllI I}

a

0, tile dialog bOx

Is re-dlsplayed so

that each

separate piece

Of the dialog has a sumJl.I'dng boX an:2 a UUe bar. You ( 3 l use tile roouse to grab Sly of the tlUe bars,

am

rrove the piece aJ'Ol.n2 within the dialog .bOx.

A size leon for the wtlole dialog bOX Is also dlsplaYf!(1, fR1 you ( 3 l use that to grow

or

ShIlA< the box.

You can ctslge a'ly Of tile text that appears In the dialog box.

You carnot add elements to the dlalog bOx. All elements rrust be defined

wnenyou

create tile dlalog tJox..

see

the docu1lentaUm a1 dialog boxeS (rot covered In tnls mcnJal) for more information.

When you

are

^Cble· editing the dialog bOx, choose _ EdIting DIalog from the debUg rTl8I'IJ. The eta gas you made to the· dialog bOx are stored wIth that docu1lent.

5.2.10. _ EdIting [XsIog

ThIs ~t1oo Is only er&lled When a dialog boX Is dlsplaYf!(1, lRt you haVe ctoseI, EdIt D1a1og. It stops dialog bOx ed1~ See aosectlon 5.2.10 Edit Olalog for rrore tnformaticn

L/$8 ToolKit Refen!noe ~ ToolKit DetJUgger 53 The ~ [)eb.1JJB"

The ToolKltlnteractlve debugger all<NS you to stop ywr ToolKit progrCJ'n ana access a. ~ Of Interactive debUg f\rlcUons. You ca'l use tile lnter~tive

N3Caeak automatically switches the display to the alternate screen.

Ttte lnter~t1ve detlJgger

Is

also InVOked When a breakpoint

Is

reached. In tnat

case,

tile alternate

screen Is

automaUca11y displayed.

SWltch1ng to tne alternate screen cDs rot affeCt the operatlm of a nmlng can find out lnformatlon abOUt Objects

am

^{methOdS. In} particular, 8SSlI1llng

yw

haVe used the BP and EP proceclJre calls to begin a'ld erKS all your

TDDIKII t:WJtgJer the trace. ·~tnlng In tne ToolKit enfOrceS level cmvenUons. t1M!Ver, the

fOllowt~ convenUons are ODserved by the ToolKit

am

^the SSTllle prograns,

cnj are recoR'meI ~

• 1, 2, a'ld 3

are

low level ToolKIt

routtnes.

• 4, 5, lIld 6 are ~t nl~r level ToolKIt

routtnes.

• 7

am

⁸ are ma)lT ToolKit routines.

• 9, 10, cn2 11 are bUIlding blOCk routines.

• 12 and n1~r are application routines.

You can also set levels In S'lCI trace the acUon of pfOCe(lBeS end tt.ncUons that are rot metnods.

use

IF and EP In tne sane.W8Y yru do wltn metnods.

I'llte that, In general, pfOCe(lBeS S'lCI fUlCUon In the ToolKIt Ulat are not metnods 00 rot call IF and EP, ^and, theIefore, do rot shoW l4) In traces, cn2

camot be traced I-kJWeVer, there Is rottdng stopping you from using BP end

EP In yrur rm-metnod pfOCe(lBeS cn2 ftroUons.

Here Is a brtef Ust of Ule f\.reUons In the

meru.

^{1lley are} deSCribed in more detall in the "osecUons Ulat follow ..

• Brea<polnt allows yru to set breakpoints on tile entrance and exlt of a metnod, procet1Jre, or fUlCUon tnat

nas

IP Sld EP calls •. In addlUon, you ccn set a breakpoint on

any

reference to ⁵¹ object of sane class. Note

that LlS8bUg

nas a

spearate breakpOint capabll1ty tnat CSl

set a

breakpoint at tIlY lnst.r'l£Um In

memory.

•

~

removes

breakpoints

set

witte tile ToolKlt debUgger.

(LlsabUg . breakpOJnts are not affected.)

• DebJgStatus prints the current watch level

am

watch

COtJ'lt am

also Ilsts

the current ToolKit deOlggel breakpoints.

• EnteILlsabug brt'9 you 1I.I,edlately lnto UsaD.Ig, making certain that the

8A>llcatlon's COde (and not system COde) Is nmlng.

• Go contlrues your prognm's executlcn

• PIOttJl tums the interactive meru display on or Off. It c:Joes not otherwise

affect the q»eratlon of U. debugger or your PlOQIaln.

• StadtCnIwl stows the call secpnJe currenUy In effeCt,. all the way back

to your main proonm It Is slmllar to tne sc com naI 0 Is Llsab Ig.

• F~ prints out InformaUon about one of the stack ^fnmes displayed

~y StackCrawL

• Inspecta»jBCt prints lnfonnaUon about 8lY Clasca1 object currenUy used by your prognm.

Uss ToolKIt ReftJn!nce MInIsI

• MeITIQ DJ"I1) dlsplays

a portion

of meroory.

ThIs

ftmUon WOrks like LlsabUg's CM corrmer d.

see

the debUgger Chapter of the Workst'q) rT81.I8l

for roore lnformaUoo.

• Lev8lsTowatd'l sets the mlnlrrun level routlne that

Is

printed When you previOUSly set breakpoints, tile breakpoints operate When that dOCUnent 1s processed.

Dans le document The Usa Applications (Page 63-67)