1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
<html dir="ltr"><head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<META HTTP-EQUIV="assetid" CONTENT="HV01085629"><META NAME="lcid" CONTENT="1033"><title>Scratch Element</title><link rel="stylesheet" type="text/css" href="office10.css"><script type="text/javascript" language="Javascript" src="ExpCollapse.js"></script><script type="text/javascript" language="JavaScript" src="inline.js"></script></head><body><h1>Scratch Element</h1><p>
<p>Contains a work area for entering and testing formulas that are referred to by other elements. This element is typically used to isolate repeated complex calculations.</p>
</p><h2>Syntax</h2><pre><code>
<Scratch
[IX]
[Del]>
</Scratch>
</code></pre><h2>Attributes</h2><p><b class="bterm">IX</b></p><p>Optional int. The zero-based index of the element within its parent element.</p><p><b class="bterm">Del</b></p><p>Optional boolean. A flag indicating whether the element has been deleted locally. A value of 1 indicates that the element was deleted locally.</p><h2>Element properties</h2><table><tr><th>Property</th><th>Value</th></tr>
<tr><td>Name</td><td>Scratch</td></tr>
<tr><td>Minimum Occurrences</td><td>0</td></tr>
<tr><td>Maximum Occurrences</td><td>Unbounded</td></tr>
</table><h2>Element information</h2><p><b class="bterm">Parent elements</b></p><p><a href="vixmlelemPageSheet.htm" id="HV01085573" lcid=""><b class="bterm">PageSheet</b></a></p><p><a href="vixmlelemShape.htm" id="HV01085631" lcid=""><b class="bterm">Shape</b></a></p><p><a href="vixmlelemStyleSheet.htm" id="HV01085684" lcid=""><b class="bterm">StyleSheet</b></a></p><p><a href="vixmlelemDocumentSheet.htm" id="HV01085388" lcid=""><b class="bterm">DocumentSheet</b></a></p><p><b class="bterm">Child elements</b></p><p><a href="vixmlelemX.htm" id="HV01085736" lcid=""><b class="bterm">X</b></a></p><p><a href="vixmlelemY.htm" id="HV01085748" lcid=""><b class="bterm">Y</b></a></p><p><a href="vixmlelemA.htm" id="HV01085287" lcid=""><b class="bterm">A</b></a></p><p><a href="vixmlelemB.htm" id="HV01085310" lcid=""><b class="bterm">B</b></a></p><p><a href="vixmlelemC.htm" id="HV01085330" lcid=""><b class="bterm">C</b></a></p><p><a href="vixmlelemD.htm" id="HV01085368" lcid=""><b class="bterm">D</b></a></p><h2>Remarks</h2><p>
<p>Elements contained in the <b class="bterm">Scratch</b> element use units in two different ways. <a href="vixmlelemX.htm" id="HV01085736" lcid=" "><b class="bterm">X</b></a> and <a href="vixmlelemY.htm" id="HV01085748" lcid=" "><b class="bterm">Y</b></a> elements use drawing units; <a href="vixmlelemA.htm" id="HV01085287" lcid=" "><b class="bterm">A</b></a>, <a href="vixmlelemB.htm" id="HV01085310" lcid=" "><b class="bterm">B</b></a>, <a href="vixmlelemC.htm" id="HV01085330" lcid=" "><b class="bterm">C</b></a>, and <a href="vixmlelemD.htm" id="HV01085368" lcid=" "><b class="bterm">D</b></a> elements don't use units. (In C programmers' jargon, <b class="bterm">X</b> and <b class="bterm">Y</b> elements are "typed," and elements <b class="bterm">A</b> through <b class="bterm">D</b> are "void.") The <b class="bterm">X</b> and <b class="bterm">Y</b> elements are often used for deriving <i>x-</i> and <i>y-</i>coordinates, such as <b class="bterm">PinX</b> and <b class="bterm">PinY</b> (the <b class="bterm">X</b> and <b class="bterm">Y</b> elements found in a <a href="vixmlelemGeom.htm" id="HV01085445" lcid=" ">Geom</a> element). Elements <b class="bterm">A</b> through <b class="bterm">D</b> can display whatever units you specify.</p>
<p>An additional difference is the way these elements store point values. A point in Microsoft Office Visio is a single data package for an (<i>x,y</i>) coordinate. When a formula returns a point value, that value is interpreted in one of three ways, depending on the element the formula is in. Elements that relate to <i>x-</i>coordinates (for example, <b class="bterm">PinX</b>, or <b class="bterm">X</b> elements of a <b class="bterm">Geom</b> element) extract just the <i>x-</i>coordinate part of a point value. Elements that relate to <i>y-</i>coordinates extract just the <i>y-</i>coordinate part of a point value.</p>
<p>For example, Visio extracts the formula PNT(3,4) in these three ways.</p>
</p><table>
<tr>
<th>
<p>
<b class="bterm">Element</b>
</p>
</th>
<th>
<b class="bterm">If you enter</b>
</th>
<th>
<b class="bterm">Visio treats it as</b>
</th>
<th>
<b class="bterm">Result</b>
</th>
</tr>
<tr>
<td>
<b class="bterm">X</b>
</td>
<td>
<p>PNT(3,4)</p>
</td>
<td>
<p>PNTX(PNT(3,4))</p>
</td>
<td>
<p>3.0000 in.</p>
</td>
</tr>
<tr>
<td>
<b class="bterm">Y</b>
</td>
<td>
<p>PNT(3,4)</p>
</td>
<td>
<p>PNTY(PNT(3,4))</p>
</td>
<td>
<p>4.0000 in.</p>
</td>
</tr>
<tr>
<td>
<b class="bterm">A-D</b>
</td>
<td>
<p>PNT(3,4)</p>
</td>
<td>
<p>PNT(3,4)</p>
</td>
<td>
<p>PNT(3.0000 in., 4.0000 in.)</p>
</td>
</tr>
</table><p>In DatadiagramML, the <b class="bterm">IX</b> values start at 0. However, in the Visio ShapeSheet user interface, row numbers start at 1. Therefore, row 1 in a ShapeSheet window is equivalent to IX='0' in the XML.</p><p>The <b class="bterm">Scratch</b> element is relevant only when contained in a <a href="vixmlelemDocumentSheet.htm" id="HV01085388" lcid=" "><b class="bterm">DocumentSheet</b></a>, <a href="vixmlelemPageSheet.htm" id="HV01085573" lcid=" "><b class="bterm">PageSheet</b></a>, or <a href="vixmlelemShape.htm" id="HV01085631" lcid=" "><b class="bterm">Shape</b></a> element. It is ignored when contained in a <a href="vixmlelemStyleSheet.htm" id="HV01085684" lcid=" "><b class="bterm">StyleSheet</b></a> element.</p><h2>See also</h2><p><a target="_blank" href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vissdk11/html/DSS_Sections_(S-Z)_1277.asp" id="HV82251277" lcid=" ">Scratch</a> section</p><center><a href="XMLSchemaCopyright_HV01147162.htm">©2003-2004 Microsoft Corporation. All rights reserved.</a>
Permission to copy, display and distribute this document is available at: <a
href="http://r.office.microsoft.com/r/rlidAWSContentRedir?AssetID=XT010988631033&CTT=11&Origin=HV011232471033"
target="_new">http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp</a></center></body></html>
|
