-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathlisting2.html
executable file
·443 lines (320 loc) · 18.8 KB
/
listing2.html
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html>
<head>
<!-- BEGIN META TAG INFO -->
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="home" href="http://developer.apple.com/">
<link rel="find" href="http://developer.apple.com/search/">
<link rel="stylesheet" type="text/css" href="../../documentation/css/adcstyle.css" title="fonts">
<script language="JavaScript" src="../../documentation/js/adc.js" type="text/javascript"></script>
<!-- END META TAG INFO -->
<!-- BEGIN TITLE -->
<title>HTMLUserPane - /docs/drawing.html</title>
<!-- END TITLE -->
<script language="JavaScript">
function JumpToNewPage() {
window.location=document.scpopupmenu.gotop.value;
return true;
}
</script>
</head>
<!-- BEGIN BODY OPEN -->
<body>
<!--END BODY OPEN -->
<!-- START CENTER OPEN -->
<center>
<!-- END CENTER OPEN -->
<!-- BEGIN LOGO AND SEARCH -->
<!--#include virtual="/includes/adcnavbar"-->
<!-- END LOGO AND SEARCH -->
<!-- START BREADCRUMB -->
<div id="breadcrumb">
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td scope="row"><img width="340" height="10" src="images/1dot.gif" alt=""></td>
<td><img width="340" height="10" src="images/1dot.gif" alt=""></td>
</tr>
<tr valign="middle">
<td align="left" colspan="2">
<a href="http://developer.apple.com/">ADC Home</a> > <a href="../../referencelibrary/index.html">Reference Library</a> > <a href="../../samplecode/index.html">Sample Code</a> > <a href="../../samplecode/Carbon/index.html">Carbon</a> > <a href="../../samplecode/Carbon/idxUserExperience-date.html">User Experience</a> > <A HREF="javascript:location.replace('index.html');">HTMLUserPane</A> >
</td>
</tr>
<tr>
<td colspan="2" scope="row"><img width="680" height="35" src="images/1dot.gif" alt=""></td>
</tr>
</table>
</div>
<!-- END BREADCRUMB -->
<div style="width:100%; position:fixed;"><div align="center" id="watermark" style="position: relative; margin-left:auto; margin-right:auto; z-index:20; width:500px;"><div class="legacybox"><h1>Not Recommended Document<span class=closebutton><a href="javascript:closeWatermark()"><img src="../../images/closebutton.png" width="14" height="14" border="0" alt="close button"></a></span></h1>
<p><strong>Important: </strong>The information in this document is <strong>Not Recommended</strong> and should not be used for new development.</p>
<div class="reflibtopic">
<p>Current information on this Reference Library topic can be found here:</p>
<ul>
<li><a href="http://developer.apple.com/referencelibrary/Carbon/idxUserExperience-date.html" target="_blank">Carbon > User Experience</a></li>
</ul>
</div>
</div></div></div>
<!-- START MAIN CONTENT -->
<!-- START TITLE GRAPHIC AND INTRO-->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td><h1><div id="pagehead">HTMLUserPane</div></h1></td>
</tr>
</table>
<!-- END TITLE GRAPHIC AND INTRO -->
<!-- START WIDE COLUMN -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td id="scdetails">
<h2>/docs/drawing.html</h2>
<form name="scpopupmenu" onSubmit="return false;" method=post>
<p><strong>View Source Code:</strong>
<select name="gotop" onChange="JumpToNewPage();" style="width:340px"><option selected value="ingnore">Select File</option>
<option value="listing1.html">/docs/display.html</option>
<option value="listing2.html">/docs/drawing.html</option>
<option value="listing3.html">/docs/generalroutines.html</option>
<option value="listing4.html">/docs/index.html</option>
<option value="listing5.html">/docs/intro.html</option>
<option value="listing6.html">/docs/types.html</option>
<option value="listing7.html">/docs/userdefined.html</option>
<option value="listing8.html">/docs/utilities.html</option>
<option value="listing9.html">/HTMLControl.c</option>
<option value="listing10.html">/HTMLControl.h</option>
<option value="listing11.html">/HTMLUserPane.c</option>
<option value="listing12.html">/HTMLUserPane.h</option>
<option value="listing13.html">/HTMLUserPane.r</option></select>
</p>
</form>
<p><strong><a href="HTMLUserPane.zip">Download Sample</a></strong> (“HTMLUserPane.zip”, 96.7K)<BR>
<strong><a href="HTMLUserPane.dmg">Download Sample</a></strong> (“HTMLUserPane.dmg”, 155.3K)</p>
<!--
<p><strong><a href="#">Download Sample</a></strong> (“filename.sit”, 500K)</p>
-->
</td>
</tr>
<tr>
<td scope="row"><img width="680" height="10" src="images/1dot.gif" alt=""><br>
<img height="1" width="680" src="images/1dot_919699.gif" alt=""><br>
<img width="680" height="20" src="images/1dot.gif" alt=""></td>
</tr>
<tr>
<td scope="row">
<!--googleon: index -->
<pre class="sourcecodebox"><HTML><HEAD> <TITLE>HTMLRenderingLib - Drawing Routines</TITLE></HEAD><BODY BGCOLOR="#FFFFFF"><H4>&nbsp;</H4><H3>HTMLRenderingLib - Routines for drawing and affecting HTMLdisplay characteristics.</H3><H4><A NAME=HRSetGrafPtr></A></H4><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRSetGrafPtr</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRSetGrafPtr( <A HREF="types.html#HRReference">HRReference</A> hrRef, GrafPtr grafPtr);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P><B>grafPtr</B> - a pointer to a quickdraw grafport where the HTML should be drawn.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>HRSetGrafPtr can be used to set the grafport an HTML renderingobject uses for drawing.</P><P><A HREF="index.html">return to index</A></P><H4><A NAME=HRActivate></A></H4><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRActivate</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRActivate( <A HREF="types.html#HRReference">HRReference</A> hrRef);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>Call HRActivate when one of a window containing an HTML renderingobject receives an activate event.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRDeactivate></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRDeactivate</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRDeactivate( <A HREF="types.html#HRReference">HRReference</A> hrRef);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>Call HRDeactivate when one of a window containing an HTMLrendering object receives an deactivate event.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRDraw></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRDraw</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRDraw( <A HREF="types.html#HRReference">HRReference</A> hrRef, RgnHandle updateRgnH);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P><B>updateRgnH</B> - if not NULL, updateRgnH contains a region handle representing the area of the screen that should be redrawn. Normally, for update events, you will provide the window's visRgn in this parameter.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>Call HRDraw when one of a window containing an HTML renderingobject receives an update event, or when you would like to redraw theHTML being displayed by an HTML rendering object.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRSetRenderingRect></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRSetRenderingRect</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRSetRenderingRect( <A HREF="types.html#HRReference">HRReference</A> hrRef, const Rect *renderingRect);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P><B>renderingRect</B> - a pointer to a QuickDraw Rect structure defining the rectangle where the HTML should be drawn. This rectangle will include the HTML and the scroll bars when they are visible.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>Call HRSetRenderingRect to set the rectangle where the HTMLrendering object should draw.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRGetRenderedImageSize></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRGetRenderedImageSize</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRGetRenderedImageSize( <A HREF="types.html#HRReference">HRReference</A> hrRef, Point *renderingSize);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P><B>renderingSize</B> - a pointer to a QuickDraw Point structure.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>HRGetRenderedImageSize can be used to establish the actual size ofthe rendered HTML given the viewing rectangle specified in the lastcall to <A HREF="#HRSetRenderingRect">HRSetRenderingRect</A>. </P><P>NOTE: HTMLRenderingLib does its best to fit the HTML into theviewing rectangle, however in some cases its width or height mayextend beyond the boundaries of this rectangle.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRScrollToLocation></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRScrollToLocation</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRScrollToLocation( <A HREF="types.html#HRReference">HRReference</A> hrRef, Point *location);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P><B>location</B> - a pointer to a QuickDraw Point structure describing the horizontal and vertical coordinates (inside of the rendered HTML image) that should be moved to the top left corner of the view rectangle.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>Cal HRScrollToLocation to set the viewing origin to a particularlocation inside of the rendered HTML document.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRForceQuickdraw></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRForceQuickdraw</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRForceQuickdraw( <A HREF="types.html#HRReference">HRReference</A> hrRef, Boolean forceQuickdraw);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P><B>forceQuickdraw</B> - a boolean value.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>Call HRForceQuickdraw to turn on and off QuickDraw drawing. It isappropriate to turn on QuickDraw drawing when asking theHTMLRenderingLib to draw to some devices such as, for example,printers.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRSetScrollbarState></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRSetScrollbarState</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRSetScrollbarState( <A HREF="types.html#HRReference">HRReference</A> hrRef, <A HREF="types.html#HRScrollbarState">HRScrollbarState</A> hScrollbarState, <A HREF="types.html#HRScrollbarState">HRScrollbarState</A> vScrollbarState);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P><B>hScrollbarState</B> - a value of type <A HREF="types.html#HRScrollbarState">HRScrollbarState</A> specifying the state for the horizontal scroll bar. This can be either eHRScrollbarOn, eHRScrollbarOff, or eHRScrollbarAuto.</P> <P><B>vScrollbarState</B> - a value of type <A HREF="types.html#HRScrollbarState">HRScrollbarState</A> specifying the state for the vertical scroll bar. This can be either eHRScrollbarOn, eHRScrollbarOff, or eHRScrollbarAuto.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>HRSetScrollbarState can be called to explicity turn on or of thescroll bars in the rendering area. By default, the scroll bars areset to automatically show/hide themselves as appropriate depending onthe size of the HTML image being displayed.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRSetDrawBorder></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRSetDrawBorder</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRSetDrawBorder( HRReference hrRef, Boolean drawBorder);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P><B>drawBorder</B> -a boolean value.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>Call HRSetDrawBorder to ask the HTMLRenderingLib to draw astandard border around the outside of the area specified in the to<A HREF="#HRSetRenderingRect">HRSetRenderingRect</A> call.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRSetGrowboxCutout></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRSetGrowboxCutout</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRSetGrowboxCutout( HRReference hrRef, Boolean allowCutout);</PRE> <P><B>hrRef</B> - a reference to a HTML rendering object previously obtained by calling <A HREF="generalroutines.html#HRNewReference">HRNewReference</A>.</P> <P><B>allowCutout</B> - a boolean value.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>Call HRSetGrowboxCutout to notify the HTML rendering object thatthe HTML is being rendered inside of a window that has a grow box inthe bottom right hand corner. If allowCutout is true, then theHTMLRenderingLib will not draw in the bottom right 16 by 16 pixelarea of the viewing rectangle.</P><P><A HREF="index.html">return to index</A></P><P>&nbsp;</P><P></P></BODY></HTML></pre>
<!--googleoff: index -->
</td>
</tr>
</table>
<!-- END WIDE COLUMN -->
<!-- END MAIN CONTENT -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td><div style="width: 100%; height: 1px; background-color: #919699; margin-top: 5px; margin-bottom: 15px"></div></td>
</tr>
<tr>
<td align="center"><br/>
<table border="0" cellpadding="0" cellspacing="0" class="graybox">
<tr>
<th>Did this document help you?</th>
</tr>
<tr>
<td>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=1&url=/samplecode/HTMLUserPane/listing2.html%3Fid%3DDTS10000580-1.0&media=dvd" target=_new>Yes</a>: Tell us what works for you.</div>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=2&url=/samplecode/HTMLUserPane/listing2.html%3Fid%3DDTS10000580-1.0&media=dvd" target=_new>It’s good, but:</a> Report typos, inaccuracies, and so forth.</div>
<div><a href="http://developer.apple.com/feedback/?v=3&url=/samplecode/HTMLUserPane/listing2.html%3Fid%3DDTS10000580-1.0&media=dvd" target=_new>It wasn’t helpful</a>: Tell us what would have helped.</div>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- START BOTTOM APPLE NAVIGATION -->
<!--#include virtual="/includes/footer"-->
<!-- END BOTTOM APPLE NAVIGATION -->
<!-- START CENTER CLOSE -->
</center>
<!-- END CENTER CLOSE -->
</body>
</html>