ZealOS/docs/Doc/KeyDev.DD.html
2021-12-11 06:10:58 -05:00

47 lines
4.6 KiB
HTML
Executable file

<!DOCTYPE HTML>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=US-ASCII">
<meta name="generator" content="ZealOS V1.07">
<style type="text/css">
body {background-color:#1f1f1f;}
.cF0{color:#e3e3e3;background-color:#1f1f1f;}
.cF1{color:#4f84a6;background-color:#1f1f1f;}
.cF2{color:#73a255;background-color:#1f1f1f;}
.cF3{color:#297582;background-color:#1f1f1f;}
.cF4{color:#b34f4b;background-color:#1f1f1f;}
.cF5{color:#8a52c3;background-color:#1f1f1f;}
.cF6{color:#b7822f;background-color:#1f1f1f;}
.cF7{color:#444444;background-color:#1f1f1f;}
.cF8{color:#6d6d6d;background-color:#1f1f1f;}
.cF9{color:#94bfde;background-color:#1f1f1f;}
.cFA{color:#a1ce97;background-color:#1f1f1f;}
.cFB{color:#6db4be;background-color:#1f1f1f;}
.cFC{color:#e88e88;background-color:#1f1f1f;}
.cFD{color:#ca94e8;background-color:#1f1f1f;}
.cFE{color:#d4b475;background-color:#1f1f1f;}
.cFF{color:#1f1f1f;background-color:#1f1f1f;}
</style>
</head>
<body>
<pre style="font-family:monospace;font-size:12pt">
<a name="l1"></a><span class=cF0>The editor mostly stays in a </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/SerialDev/Message.ZC.html#l170"><span class=cF4>KeyGet</span></a><span class=cF0>()/</span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KeyDev.ZC.html#l1"><span class=cF4>PutKey</span></a><span class=cF0>() loop. The putkey portion is where keys are acted-upon. ZealOS has a chain
<a name="l2"></a>of putkey handlers in a </span><span class=cF4><u>Circular Queue</u></span><span class=cF0> with priorities. The highest priority handlers can choose to terminate handling,
<a name="l3"></a>otherwise, the keys get sent on down the chain.
<a name="l4"></a></span><span class=cF4>
<a name="l5"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KeyDev.ZC.html#l81"><span class=cF4>KeyDevAdd</span></a><span class=cF0>() defines a putkey device with a priority. &quot;Device&quot; might be a misnomer. Currently, the following are defined:
<a name="l6"></a>
<a name="l7"></a>Priority Handler
<a name="l8"></a>---------- ---------
<a name="l9"></a></span><span class=cF2>0x20000000</span><span class=cF0> </span><a href="https://zeal-operating-system.github.io/ZealOS/Home/HomeKeyPlugIns.ZC.html#l11"><span class=cF4>MyPutKey</span></a><span class=cF0>() user handler
<a name="l10"></a></span><span class=cF2>0x40000000</span><span class=cF0> </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KeyDev.ZC.html#l124"><span class=cF4>KDInputFilterPutKey</span></a><span class=cF0>() for </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.ZC.html#l580"><span class=cF4>In</span></a><span class=cF0>(), </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.ZC.html#l561"><span class=cF4>InStr</span></a><span class=cF0>(), and </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/Job.ZC.html#l572"><span class=cF4>InFile</span></a><span class=cF0>() handling.
<a name="l11"></a></span><span class=cF2>0x60000000</span><span class=cF0> </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KeyDev.ZC.html#l99"><span class=cF4>KDRawPutKey</span></a><span class=cF0>() nonwindowed direct to video mem debug output.
<a name="l12"></a></span><span class=cF2>0x80000000</span><span class=cF0> </span><a href="https://zeal-operating-system.github.io/ZealOS/System/DolDoc/DocPutKey.ZC.html#l948"><span class=cF4>KDDocPutKey</span></a><span class=cF0>() standard document cmds
<a name="l13"></a>
<a name="l14"></a>Since handling individual keys is slow, ZealOS supports PutS() as well. If no puts handler is defined, individual keys are
<a name="l15"></a>sent.
<a name="l16"></a></span><span class=cF4>
<a name="l17"></a></span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KernelA.HH.html#l1502"><span class=cF4>CDoc</span></a><span class=cF2>.user_put_key</span><span class=cF0> and </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KernelA.HH.html#l1502"><span class=cF4>CDoc</span></a><span class=cF2>.user_put_s</span><span class=cF0> are call back routines which offer some neat tricks. See </span><a href="https://zeal-operating-system.github.io/ZealOS/Apps/Psalmody/JukeBox.ZC.html#l1"><span class=cF4>::/Apps/Psalmody/JukeBox.ZC</span></a><span class=cF0>.
<a name="l18"></a>There is a variable </span><a href="https://zeal-operating-system.github.io/ZealOS/Kernel/KernelA.HH.html#l1502"><span class=cF4>CDoc</span></a><span class=cF2>.user_put_data</span><span class=cF0> which gets passed to them.
</span></pre></body>
</html>