-
Notifications
You must be signed in to change notification settings - Fork 3
/
listing12.html
executable file
·379 lines (287 loc) · 15.8 KB
/
listing12.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
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
<!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>HTMLSample - /HTMLSample Pages/docs/display.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');">HTMLSample</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">HTMLSample</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>/HTMLSample Pages/docs/display.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">/AboutBox.c</option>
<option value="listing2.html">/AboutBox.h</option>
<option value="listing3.html">/CIconButtons.c</option>
<option value="listing4.html">/CIconButtons.h</option>
<option value="listing5.html">/CWDefines.h</option>
<option value="listing6.html">/debugf.c</option>
<option value="listing7.html">/debugf.h</option>
<option value="listing8.html">/History.c</option>
<option value="listing9.html">/History.h</option>
<option value="listing10.html">/HTMLSample Help/buttons.html</option>
<option value="listing11.html">/HTMLSample Help/index.html</option>
<option value="listing12.html">/HTMLSample Pages/docs/display.html</option>
<option value="listing13.html">/HTMLSample Pages/docs/drawing.html</option>
<option value="listing14.html">/HTMLSample Pages/docs/generalroutines.html</option>
<option value="listing15.html">/HTMLSample Pages/docs/index.html</option>
<option value="listing16.html">/HTMLSample Pages/docs/intro.html</option>
<option value="listing17.html">/HTMLSample Pages/docs/types.html</option>
<option value="listing18.html">/HTMLSample Pages/docs/userdefined.html</option>
<option value="listing19.html">/HTMLSample Pages/docs/utilities.html</option>
<option value="listing20.html">/HTMLSample Pages/error.html</option>
<option value="listing21.html">/HTMLSample Pages/index.html</option>
<option value="listing22.html">/HTMLSample.c</option>
<option value="listing23.html">/HTMLSample.h</option>
<option value="listing24.html">/HTMLSample.r</option>
<option value="listing25.html">/RenderingWindow.c</option>
<option value="listing26.html">/RenderingWindow.h</option>
<option value="listing27.html">/SampleUtils.c</option>
<option value="listing28.html">/SampleUtils.h</option></select>
</p>
</form>
<p><strong><a href="HTMLSample.zip">Download Sample</a></strong> (“HTMLSample.zip”, 279.4K)<BR>
<strong><a href="HTMLSample.dmg">Download Sample</a></strong> (“HTMLSample.dmg”, 330.4K)</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 - HTML Display Routines</TITLE></HEAD><BODY BGCOLOR="#FFFFFF"><H3>&nbsp;</H3><H3>HTMLRenderingLib - Routines for selecting HTML files fordisplay</H3><H4><A NAME=HRGoToURL></A></H4><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRGoToURL</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRGoToURL( <A HREF="types.html#HRReference">HRReference</A> hrRef, const char * url, Boolean addToHistory, Boolean forceRefresh);</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>url</B> - a pointer to a C - style string containing the url to display. This URL should begin with the resource type specifier "file:".</P> <P><B>addToHistory</B> - a boolean value.</P> <P><B>forceRefresh</B> - a boolean value.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>HRGoToURL can be used to ask the HTML object to display the filespecified by the URL. addToHistory will be passed through to your<A HREF="userdefined.html#MyHRNewURLProc">MyHRNewURLProc</A> if youhave defined one. If forceRefresh is true, then the view rectanglewill be redrawn.</P><P><A HREF="index.html">return to index</A></P><H4><A NAME=HRGoToAnchor></A></H4><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRGoToAnchor</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRGoToAnchor( <A HREF="types.html#HRReference">HRReference</A> hrRef, const char * anchorName); </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>anchorName</B> - A pointer to a C - style string containing the name of the anchor to scroll into the display.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>Call HRGoToAnchor to scroll display so that a particular anchorinside of the HTML image is visible.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRGoToPtr></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRGoToPtr</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRGoToPtr( <A HREF="types.html#HRReference">HRReference</A> hrRef, char * buffer, UInt32 bufferSize, Boolean addToHistory, Boolean forceRefresh);</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>buffer</B> - a pointer to a block of memory containing the HTML to display.</P> <P><B>bufferSize</B> - the number of bytes in the block pointed to by buffer.</P> <P><B>addToHistory</B> - a boolean value.</P> <P><B>forceRefresh</B> - a boolean value.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>HRGoToPtr allows you render HTML from memory. addToHistory will bepassed through to your <A HREF="userdefined.html#MyHRNewURLProc">MyHRNewURLProc</A>if you have defined one. If forceRefresh is true, then the viewrectangle will be redrawn.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRGetRootURL></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRGetRootURL</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRGetRootURL( <A HREF="types.html#HRReference">HRReference</A> hrRef, Handle rootURLH);</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>rootURLH</B> - a handle. This handle must be allocated by the caller before this routine is called.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>HRGetRootURL returns a C - style string inside of a memory blockrefered to by a Handle that contains the root URL used for allrelative links given image is currently in the display. </P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRGetBaseURL></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRGetBaseURL</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRGetBaseURL( <A HREF="types.html#HRReference">HRReference</A> hrRef, Handle baseURLH);</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>baseURLH</B> - a handle. This handle must be allocated by the caller before this routine is called.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>If the HTML file showing in the display contains a &lt;BASE&gt;tag, then HRGetBaseURL will return a C - style string inside of amemory block refered to by a Handle containing it's value. If thefile does not contain a &lt;BASE&gt; tag, then the Handle is set toan empty string.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRGetHTMLURL></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRGetHTMLURL</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRGetHTMLURL( <A HREF="types.html#HRReference">HRReference</A> hrRef, Handle HTMLURLH);</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>HTMLURLH</B> - a handle. This handle must be allocated by the caller before this routine is called.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>HRGetHTMLURL returns the URL for the page currently visible in thedisplay. The URL will be returned in a C - style string inside of thememory block refered to by Handle provided in the HTMLURLHparameter.</P><P><A HREF="index.html">return to index</A></P><P><A NAME=HRGetTitle></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">HRGetTitle</FONT></H4><BLOCKQUOTE><PRE>OSStatus HRGetTitle( <A HREF="types.html#HRReference">HRReference</A> hrRef, StringPtr title);</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>title</B> - a pointer to a variable of type Str255.</P> <P>function result - an error code or noErr if successful.</P></BLOCKQUOTE><P>HRGetTitle returns the title of the HTML file visible in thedisplay. This title is appropriate for setting a window's title.</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/HTMLSample/listing12.html%3Fid%3DDTS10000579-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/HTMLSample/listing12.html%3Fid%3DDTS10000579-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/HTMLSample/listing12.html%3Fid%3DDTS10000579-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>