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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE>XmHTML Programmers Manual: XmHTMLImageReplace</TITLE>
<META HTTP-EQUIV="Keywords" CONTENT="XmHTML, HTML, Motif, Widget, eXode, XntHelp, Linux">
<META HTTP-EQUIV="Reply-to" CONTENT="ripley@xs4all.nl">
<META HTTP-EQUIV="Description" CONTENT="XmHTMLImageReplace - replace an image with another image in the currently displayed document.">
<META NAME="Author" CONTENT="Koen D'Hondt">
<META NAME="Copyright" content="1995-1997 by Ripley Software Development">
<META NAME="Source" content="$Source$">
<META NAME="Revision" content="$Revision$">
<META NAME="Font" content="helvetica">
<link rev="made" href="mailto:ripley@xs4all.nl">
<link rel="home" href="index.html">
<link rel="previous" href="ImPLCSus.html">
<link rel="next" href="ImUpdate.html">
<link rel="up" href="../man.html">
<link rel="copyright" href="copyrights.html">
</HEAD>
<BODY BGCOLOR="#FFFFFF" text="#000000">
<h3><font face="helvetica,arial">Name</font></h3>
<blockquote>
XmHTMLImageReplace - replace an image with another image in the currently displayed document.
</blockquote>
<h3><font face="helvetica,arial">Synopsis</font></h3>
<blockquote>
XmImageStatus XmHTMLImageReplace(Widget w, XmImageInfo *image,
XmImageInfo *new_image)
</blockquote>
<h3><font face="helvetica,arial">Description</font></h3>
<blockquote>
XmHTMLImageReplace allows one to replace an existing image with
a new one. This function is typically used in combination with
delayed image loading. Delayed Image Loading takes place when
the function installed on the XmNimageProc resource sets the
XmIMAGE_DELAYED option bit on the returned XmImageInfo structure. This
bit signals XmHTML that the actual image will be provided at a later stage
(for example, the image needs to be fetched from a remote location).
<p>
When the image data has become available, the XmHTMLImageReplace
function can be used to inform a XmHTML widget that the image is
readily available and the delayed image should be replaced with the
real image data.
<p>
<dl>
<dt>w
<dd>Specifies the parent Widget ID, which must be of class
xmHTMLWidgetClass.
<dt>*image
<dd>the image that is to be replaced.
<dt>*new_image
<dd>the new image data.
</dl>
</blockquote>
<h3><font face="helvetica,arial">Return Value</font></h3>
<blockquote>
Any of the following values:
</blockquote>
<pre>
typedef enum{
XmIMAGE_ERROR /* unknown error occured */
XmIMAGE_BAD /* bad function call: missing arguments */
XmIMAGE_UNKNOWN /* provided XmImageInfo structure unknown/unbound */
XmIMAGE_ALMOST /* action completed, further response necessary */
XmIMAGE_OK /* action completed. */
}XmImageStatus;
</pre>
<blockquote>
A return value of XmIMAGE_ALMOST indicates that a redisplay of the
current document is necessary (this value can be returned if the
dimensions of the new image differ from the image that it replaced).
</blockquote>
<h3><font face="helvetica,arial">See Also</font></h3>
<blockquote>
XmHTML(3X), XmHTMLImageDefaultProc(3X), XmHTMLImageUpdate(3X),
XmHTMLRedisplay(3X), XmImageInfo(3X)
</blockquote>
<hr noshade size="2" width="25%">
<i><font size="-1">
XmHTML, June 4, 1998
</font></i>
</body>
</html>
|
