For runtimes that use a view on the application canvas as the debugger console window,
the optional <debug /> tag controls the appearance
of window.
The <debug /> tag does not
cause the application to be compiled with debugging mode enabled.
When applicable, by default, the debug console will appear as a view
sized to fit the lower 1/2 of the canvas.
The usual view attributes can be used to override these defaults to size and
position the debug console window. If you need to programmatically
control the debugger console window, use the name
attribute:
Example 2. Controlling the Debug console window
<canvas debug="true" height="150" width="100%">
<debug name="debugwindow" y="${canvas.height - this.height}" height="80%"/>
<button name="button">
<attribute name="visible" value="${canvas['debugwindow'] != null}"/>
<attribute name="text" value="${canvas['debugwindow']?((canvas.debugwindow.visible?'hide':'show') + ' debugger'):null}"/>
<handler name="onclick">
canvas.debugwindow.setAttribute('visible', (! canvas.debugwindow.visible));
</handler>
</button>
</canvas>
Note the test to verify that the window exists before we try to manipulate it.
The <debug /> tag will not create
a window in the application canvas for runtimes or IDE's that have an external debugger console,
or if remote or developer console debugging
is enabled.
When the debugger is active, there is a menu item in the default contextual (right-click) menu that can be used to show or hide the debugger window. The debugger will add a number of useful actions to the contextual menu when the debugger window is visible. If an error occurred in the program, there will be actions to examine the error in detail or to generate a bug report.
Attributes inherited from <view>
aaactive, aadescription, aaname, aasilent, aatabindex, align, backgroundrepeat, bgcolor, cachebitmap, capabilities, clickable, clickregion, clip, colortransform, context, contextmenu, cornerradius, cursor, fgcolor, focusable, focustrap, font, fontsize, fontstyle, frame, framesloadratio, hasdirectionallayout, hassetheight, hassetwidth, height, layout, loadratio, mask, opacity, pixellock, playing, proxyurl, resource, resourceheight, resourcewidth, rotation, shadowangle, shadowblurradius, shadowcolor, shadowdistance, showhandcursor, source, stretches, subviews, tintcolor, totalframes, unstretchedheight, unstretchedwidth, usegetbounds, valign, visibility, visible, width, x, xoffset, xscale, y, yoffset, yscale
Attributes inherited from <node>
classroot, cloneManager, data, datapath, defaultplacement, id, ignoreplacement, immediateparent, inited, initstage, name, nodeLevel, options, parent, placement, styleclass, subnodes, transition
Methods
Methods inherited from <view>
bringToFront, containsPt, getAttributeRelative, getBounds, getColor, getColorTransform, getCurrentTime, getDepthList, getDisplayObject, getID3, getMouse, getNextSelection, getPan, getPrevSelection, getProxyURL, getTotalTime, getVolume, init, isBehind, isInFrontOf, isMouseOver, measureHeight, measureWidth, play, proxyurl, searchSubviews, seek, sendAAEvent, sendBehind, sendInFrontOf, sendToBack, setAccessible, setAttributeRelative, setColor, setColorTransform, setPan, setProxyPolicy, setSource, setVolume, shouldYieldFocus, stop, unload, updateResourceSize
Methods inherited from <node>
animate, applyConstraintMethod, applyData, childOf, completeInstantiation, construct, createChildren, dataBindAttribute, destroy, determinePlacement, getOption, getUID, init, lookupSourceLocator, releaseConstraint, releaseConstraintMethod, searchImmediateSubnodes, searchSubnodes, setOption, setSelected, updateData
Events
Events inherited from <view>
onaddsubview, onbackgroundrepeat, onblur, onclick, onclickable, onclip, oncontext, oncornerradius, ondblclick, onerror, onfocus, onframe, onframesloadratio, ongesture, onheight, onkeydown, onkeyup, onlastframe, onload, onloadratio, onmousedown, onmousedragin, onmousedragout, onmouseout, onmouseover, onmousetrackout, onmousetrackover, onmousetrackup, onmouseup, onmouseupoutside, onopacity, onplay, onplaying, onremovesubview, onshadowangle, onshadowblurradius, onshadowcolor, onshadowdistance, onstop, ontimeout, ontouch, onvisible, onwidth, onx, ony