Autodesk 15606-011408-9300 Developer Guide - Page 65

Setting the Print Priority, Element, Default Print Priority

Page 65 highlights

Setting the Print Priority As shown above, you can write an onEndLayout event handler that uses MGPrintLayout, MGPageElement, and MGExtentEx to control the placement of printed page elements. It is possible, and sometimes desirable, to place page elements on top of each other. For example, you might want to place the North arrow on top of an empty spot of ocean in your map. Of course, this doesn't do your user much good if the ocean prints on top of the North arrow and hides it. To solve this problem, each page element is assigned a default print priority. A print priority is a positive floating-point number between 0.0 and 100.0 that describes the relative printing order of a page element. The element with the lowest number is printed first. The element with the highest number is printed last. You can read and change an element's priority with the getPrintPriority and setPrintPriority methods, but the default values are as follows: Element map legend title URL date/time scale bar North arrow custom elements Default Print Priority 10.0 20.0 30.0 40.0 50.0 60.0 70.0 80.0 Working with Printing | 65

  • 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
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208

Working with Printing
|
65
Setting the Print Priority
As shown above, you can write an
onEndLayout
event handler that uses
MGPrintLayout
,
MGPageElement
, and
MGExtentEx
to control the place-
ment of printed page elements. It is possible, and sometimes desirable, to
place page elements on top of each other. For example, you might want to
place the North arrow on top of an empty spot of ocean in your map. Of
course, this doesn
t do your user much good if the ocean prints on top of the
North arrow and hides it.
To solve this problem, each page element is assigned a default print priority.
A print priority is a positive floating-point number between 0.0 and 100.0
that describes the relative printing order of a page element. The element with
the lowest number is printed first. The element with the highest number is
printed last. You can read and change an element
s priority with the
getPrintPriority
and
setPrintPriority
methods, but the default
values are as follows:
Element
Default Print Priority
map
10.0
legend
20.0
title
30.0
URL
40.0
date/time
50.0
scale bar
60.0
North arrow
70.0
custom elements
80.0