/usr/share/doc/racket/mysterx/com-events.html is in racket-doc 6.1-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><title>3 COM Events</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,"tocview_0");">▼</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">Myster<span class="mywbr"> </span>X:<span class="mywbr"> </span> Legacy Support for Windows COM</a></td></tr></table></div><div class="tocviewsublistonly" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1 </td><td><a href="methprop.html" class="tocviewlink" data-pltdoc="x">COM Methods and Properties</a></td></tr><tr><td align="right">2 </td><td><a href="com-types.html" class="tocviewlink" data-pltdoc="x">COM Types</a></td></tr><tr><td align="right">3 </td><td><a href="" class="tocviewselflink" data-pltdoc="x">COM Events</a></td></tr><tr><td align="right">4 </td><td><a href="version.html" class="tocviewlink" data-pltdoc="x">Version</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-events%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">com-<wbr></wbr>events</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-event-type%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">com-<wbr></wbr>event-<wbr></wbr>type</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-register-event-handler%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">com-<wbr></wbr>register-<wbr></wbr>event-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-unregister-event-handler%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">com-<wbr></wbr>unregister-<wbr></wbr>event-<wbr></wbr>handler</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" style="color: #888;" type="text" value="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, "6.1", "../");" onfocus="this.style.color="black"; this.style.textAlign="left"; if (this.value == "...search manuals...") this.value="";" onblur="if (this.value.match(/^ *$/)) { this.style.color="#888"; this.style.textAlign="center"; this.value="...search manuals..."; }"/></form> <a href="../index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot("6.1");">top</a></span><span class="navright"> <a href="com-types.html" title="backward to "2 COM Types"" data-pltdoc="x">← prev</a> <a href="index.html" title="up to "MysterX: Legacy Support for Windows COM"" data-pltdoc="x">up</a> <a href="version.html" title="forward to "4 Version"" data-pltdoc="x">next →</a></span> </div><h3 x-source-module="(lib "mysterx/scribblings/mysterx.scrbl")" x-part-tag=""com-events"">3<tt> </tt><a name="(part._com-events)"></a>COM Events</h3><p>COM events are generated by COM objects. Unlike
HTML events, there is no fixed set of COM
events, though there are “stock” events that
many COM objects support. MysterX allows the
programmer to write handlers for both stock and
custom events.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._mysterx/main..rkt)._com-events))"></a><span title="Provided from: mysterx | Package: mysterx"><span class="RktSym"><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-events%29%29" class="RktValDef RktValLink" data-pltdoc="x">com-events</a></span></span><span class="hspace"> </span><span class="RktVar">obj/type</span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._listof%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">obj/type</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace"> </span><span class="RktSym"><a href="methprop.html#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-object~3f%29%29" class="RktValLink" data-pltdoc="x">com-object?</a></span><span class="hspace"> </span><span class="RktSym">com-type?</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of strings naming the events supported by
<span class="RktVar">obj/type</span>.</div></p><p>If calling this procedure results in an error indicating that the
COM object’s coclass is ambiguous, try using either
<span class="RktSym"><a href="methprop.html#%28def._%28%28lib._mysterx%2Fmain..rkt%29._set-coclass%21%29%29" class="RktValLink" data-pltdoc="x">set-coclass!</a></span> or <span class="RktSym"><a href="methprop.html#%28def._%28%28lib._mysterx%2Fmain..rkt%29._set-coclass-from-progid%21%29%29" class="RktValLink" data-pltdoc="x">set-coclass-from-progid!</a></span>, then
retry <span class="RktSym"><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-events%29%29" class="RktValLink" data-pltdoc="x">com-events</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._mysterx/main..rkt)._com-event-type))"></a><span title="Provided from: mysterx | Package: mysterx"><span class="RktSym"><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-event-type%29%29" class="RktValDef RktValLink" data-pltdoc="x">com-event-type</a></span></span><span class="hspace"> </span><span class="RktVar">obj/type</span><span class="hspace"> </span><span class="RktVar">ev</span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._listof%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">obj/type</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace"> </span><span class="RktSym"><a href="methprop.html#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-object~3f%29%29" class="RktValLink" data-pltdoc="x">com-object?</a></span><span class="hspace"> </span><span class="RktSym">com-type?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">ev</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the type of an event handler for the
event <span class="RktVar">ev</span> generated by the particular
COM object/type <span class="RktVar">obj/type</span>. The return type of
all COM event handlers is void.</div></p><p>See also <span class="RktSym"><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-events%29%29" class="RktValLink" data-pltdoc="x">com-events</a></span> for dealing with a COM
object that has an ambiguous class.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._mysterx/main..rkt)._com-register-event-handler))"></a><span title="Provided from: mysterx | Package: mysterx"><span class="RktSym"><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-register-event-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">com-register-event-handler</a></span></span><span class="hspace"> </span><span class="RktVar">obj</span><span class="hspace"> </span><span class="RktVar">ev</span><span class="hspace"> </span><span class="RktVar">f</span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">obj</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="methprop.html#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-object~3f%29%29" class="RktValLink" data-pltdoc="x">com-object?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">ev</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">f</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace"> </span><span class="RktPn">. </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-></span></a></span><span class="RktPn"> .</span><span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&version=6.1" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Registers <span class="RktVar">f</span> as event handler for the event <span class="RktVar">ev</span> when
generated by <span class="RktVar">obj</span>. The type of argument supplied to
<span class="RktVar">f</span> depends on the event; the result of <span class="RktVar">f</span> is always
discarded.</div></p><p>See also <span class="RktSym"><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-events%29%29" class="RktValLink" data-pltdoc="x">com-events</a></span> for dealing with a COM
object that has an ambiguous class.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._mysterx/main..rkt)._com-unregister-event-handler))"></a><span title="Provided from: mysterx | Package: mysterx"><span class="RktSym"><a href="#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-unregister-event-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">com-unregister-event-handler</a></span></span><span class="hspace"> </span><span class="RktVar">obj</span><span class="hspace"> </span><span class="RktVar">ev</span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">obj</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="methprop.html#%28def._%28%28lib._mysterx%2Fmain..rkt%29._com-object~3f%29%29" class="RktValLink" data-pltdoc="x">com-object?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">ev</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&version=6.1" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Unregisters any event handler for the event <span class="RktVar">ev</span> that is
generated by the COM object <span class="RktVar">obj</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" style="color: #888;" type="text" value="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, "6.1", "../");" onfocus="this.style.color="black"; this.style.textAlign="left"; if (this.value == "...search manuals...") this.value="";" onblur="if (this.value.match(/^ *$/)) { this.style.color="#888"; this.style.textAlign="center"; this.value="...search manuals..."; }"/></form> <a href="../index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot("6.1");">top</a></span><span class="navright"> <a href="com-types.html" title="backward to "2 COM Types"" data-pltdoc="x">← prev</a> <a href="index.html" title="up to "MysterX: Legacy Support for Windows COM"" data-pltdoc="x">up</a> <a href="version.html" title="forward to "4 Version"" data-pltdoc="x">next →</a></span> </div></div></div><div id="contextindicator"> </div></body></html>
|