-
Notifications
You must be signed in to change notification settings - Fork 3
/
listing7.html
executable file
·305 lines (244 loc) · 12 KB
/
listing7.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/userdefined.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/userdefined.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 - User Defined Routines</TITLE></HEAD><BODY BGCOLOR="#FFFFFF"><H4>&nbsp;</H4><H3>HTMLRenderingLib - user defined routines</H3><H4><A NAME=MyHRWasURLVisitedProc></A></H4><P>&nbsp;</P><H4><FONT COLOR="#FF0000">MyHRWasURLVisitedProc</FONT></H4><BLOCKQUOTE><PRE>Boolean MyHRWasURLVisitedProc( const char *url, void *refCon);</PRE> <P><B>url</B> - a pointer to a C-style string containing the URL.</P> <P><B>refCon</B> - an application defined value you provided when calling HRRegisterWasURLVisitedUPP to associate your visited proc with a HTML rendering object.</P> <P>function result - an error code.</P></BLOCKQUOTE><P>Your visited procedure will be called whenever the HTML renderinglibrary would like to determine if a link has been visited. If youare maintaining your own database of visited links, you can use thisroutine to report visited links back to the HTML rendering library.If a link has been visited, your routine should return true. If not,then your routine should return false. </P><P>To set the visited links routine for a particular renderingobject, call the HRRegisterWasURLVisitedUPP routine. The inRefConparameter provided to this routine will be passed to your visitedroutine whenever it is called.</P><BLOCKQUOTE><PRE>void HRRegisterWasURLVisitedUPP( HRWasURLVisitedUPP inWasURLVisitedUPP, <A HREF="types.html#HRReference">HRReference</A> hrRef, void * inRefCon);</PRE></BLOCKQUOTE><P><A HREF="index.html">return to index</A></P><H4><A NAME=MyHRNewURLProc></A></H4><P>&nbsp;</P><H4><FONT COLOR="#FF0000">MyHRNewURLProc</FONT></H4><BLOCKQUOTE><PRE>OSStatus MyHRNewURLProc( const char *url, const char *targetFrame, Boolean addToHistory, void *refCon); </PRE> <P><B>url</B> - a pointer to a C-style string containing the URL.</P> <P><B>targetFrame</B> - a pointer to a C-style string containing the destination frame for the URL.</P> <P><B>addToHistory</B> - a boolean value.</P> <P><B>refCon</B> - an application defined value you provided when calling HRRegisterNewURLUPP to associate your visited proc with a HTML rendering object.</P> <P>function result - an error code.</P></BLOCKQUOTE><P>Your new url procedure will be called whenever the HTML renderinglibrary replaces the HTML image being shown in the display. Thisroutine provides an opportunity for your application to update thewindows title and add the url to a history of visited links. </P><P>To set the new url routine for a particular rendering object, callthe HRRegisterNewURLUPP routine. The inRefCon parameter provided tothis routine will be passed to your new url routine whenever it iscalled.</P><BLOCKQUOTE><PRE>void HRRegisterNewURLUPP( HRNewURLUPP inNewURLUPP, HRReference hrRef, void *inRefCon);</PRE></BLOCKQUOTE><P><A HREF="index.html">return to index</A></P><P><A NAME=MyHRURLToFSSpecProc></A></P><P>&nbsp;</P><H4><FONT COLOR="#FF0000">MyHRURLToFSSpecProc</FONT></H4><BLOCKQUOTE><PRE>OSStatus MyHRURLToFSSpecProc( const char *rootURL, const char *linkURL, FSSpec *fsspec, <A HREF="types.html#URLSourceType">URLSourceType</A> urlSourceType, void *refCon);</PRE> <P><B>rootURL</B> - can be NULL. a pointer to a C-style string containing the root URL.</P> <P><B>linkURL</B> - can be NULL. a pointer to a C-style string containing the link URL.</P> <P><B>fsspec</B> - a pointer to a file system specification record where your routine should store the location of the file to be displayed.</P> <P><B>urlSourceType</B> - a value of type <A HREF="types.html#URLSourceType">URLSourceType</A> describing the type of file the HTML rendering library is looking for.</P> <P><B>refCon</B> - an application defined value you provided when calling HRRegisterURLToFSSpecUPP to associate your visited proc with a HTML rendering object.</P></BLOCKQUOTE><P>Your new url procedure will be called whenever the HTML renderinglibrary is trying to find a file associated with a particular link orURL. This routine provides an opportunity for your application tointercept URLs re-direct them to refer to different files on disk.</P><P>To set the url to FSSpec routine for a particular renderingobject, call the HRRegisterURLToFSSpecUPP routine. The inRefConparameter provided to this routine will be passed to your url toFSSpec routine whenever it is called.</P><BLOCKQUOTE><PRE>void HRRegisterURLToFSSpecUPP( HRURLToFSSpecUPP inURLToFSSpecUPP, HRReference hrRef, void *inRefCon);</PRE></BLOCKQUOTE><P>&nbsp;</P><P><A HREF="index.html">return to index</A></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/listing7.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/listing7.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/listing7.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>