doc/html/group__hangulic.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
   3 <title>libhangul: 한글 입력 기능 구현</title>
   4 <link href="doxygen.css" rel="stylesheet" type="text/css">
   5 <link href="tabs.css" rel="stylesheet" type="text/css">
   6 </head><body>
   7 <!-- 다음에 의해 생성됨 :  Doxygen 1.5.3-20071008 -->
   8 <div class="tabs">
   9   <ul>
  10     <li><a href="index.html"><span>메인&nbsp;페이지</span></a></li>
  11     <li><a href="modules.html"><span>모듈</span></a></li>
  12     <li><a href="files.html"><span>파일들</span></a></li>
  13     <li><a href="dirs.html"><span>디렉토리</span></a></li>
  14     <li><a href="pages.html"><span>관련된&nbsp;페이지</span></a></li>
  15   </ul>
  16 </div>
  17 <h1>한글 입력 기능 구현</h1><table border="0" cellpadding="0" cellspacing="0">
  18 <tr><td></td></tr>
  19 <tr><td colspan="2"><br><h2>타입정의</h2></td></tr>
  20 <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct _HangulInputContext&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a></td></tr>
  21
  22 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">한글 입력 상태를 관리하기 위한 오브젝트  <a href="#g623ec57b85ebf33279989f3e6bc2d59a"></a><br></td></tr>
  23 <tr><td colspan="2"><br><h2>함수</h2></td></tr>
  24 <tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#g26a39855a3fb03a1f794aca464ae132e">hangul_ic_process</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic, int ascii)</td></tr>
  25
  26 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">키 입력을 처리하여 실제로 한글 조합을 하는 함수  <a href="#g26a39855a3fb03a1f794aca464ae132e"></a><br></td></tr>
  27 <tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="group__hangulctype.html#g2c1a56543786ad0dcce173493019448c">ucschar</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#gc39496296816be4b516659b322e73d64">hangul_ic_get_preedit_string</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  28
  29 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">현재 상태의 preedit string을 구하는 함수  <a href="#gc39496296816be4b516659b322e73d64"></a><br></td></tr>
  30 <tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="group__hangulctype.html#g2c1a56543786ad0dcce173493019448c">ucschar</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#gbe09f347ac91563b4dd45f93c5bd9a03">hangul_ic_get_commit_string</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  31
  32 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">현재 상태의 commit string을 구하는 함수  <a href="#gbe09f347ac91563b4dd45f93c5bd9a03"></a><br></td></tr>
  33 <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#g2fa2f5972adbdacd38e1edf62ff9fc53">hangul_ic_reset</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  34
  35 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 초기상태로 되돌리는 함수  <a href="#g2fa2f5972adbdacd38e1edf62ff9fc53"></a><br></td></tr>
  36 <tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="group__hangulctype.html#g2c1a56543786ad0dcce173493019448c">ucschar</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#g40e3e40e46d1554a6e2e85280396a6b5">hangul_ic_flush</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  37
  38 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 입력 상태를 완료하는 함수  <a href="#g40e3e40e46d1554a6e2e85280396a6b5"></a><br></td></tr>
  39 <tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#g8d886ba7f2e3adb1fbc8c00d58b825b3">hangul_ic_backspace</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  40
  41 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 backspace 키를 처리하도록 하는 함수  <a href="#g8d886ba7f2e3adb1fbc8c00d58b825b3"></a><br></td></tr>
  42 <tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#g392305eaf52e31967719fc039b267956">hangul_ic_is_empty</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  43
  44 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 글자를 가지고 있는지 확인하는 함수  <a href="#g392305eaf52e31967719fc039b267956"></a><br></td></tr>
  45 <tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#gf6a03d6bf05b58cc50ed10e2c7172a33">hangul_ic_has_choseong</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  46
  47 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 초성을 가지고 있는지 확인하는 함수  <a href="#gf6a03d6bf05b58cc50ed10e2c7172a33"></a><br></td></tr>
  48 <tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#g4509b431ce3a9c8b2b74120ea5dde9b5">hangul_ic_has_jungseong</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  49
  50 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 중성을 가지고 있는지 확인하는 함수  <a href="#g4509b431ce3a9c8b2b74120ea5dde9b5"></a><br></td></tr>
  51 <tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#gcef5c615ac50da4dc99f50934739c424">hangul_ic_has_jongseong</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  52
  53 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 종성을 가지고 있는지 확인하는 함수  <a href="#gcef5c615ac50da4dc99f50934739c424"></a><br></td></tr>
  54 <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#g7dd66ed8f04fe95ff401f2b29e10db1f">hangul_ic_select_keyboard</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic, const char *id)</td></tr>
  55
  56 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 자판 배열을 바꾸는 함수  <a href="#g7dd66ed8f04fe95ff401f2b29e10db1f"></a><br></td></tr>
  57 <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#g323e53954c0fe5869ffc4cbcfc2be897">hangul_ic_new</a> (const char *keyboard)</td></tr>
  58
  59 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> 오브젝트를 생성한다.  <a href="#g323e53954c0fe5869ffc4cbcfc2be897"></a><br></td></tr>
  60 <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#g3f153cf60e726535ad175ebb894f584d">hangul_ic_delete</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  61
  62 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 삭제하는 함수  <a href="#g3f153cf60e726535ad175ebb894f584d"></a><br></td></tr>
  63 <tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__hangulic.html#gc9e3230e98035854b806436d0569596e">hangul_ic_is_transliteration</a> (<a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *hic)</td></tr>
  64
  65 <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">주어진 hic가 transliteration method인지 판별  <a href="#gc9e3230e98035854b806436d0569596e"></a><br></td></tr>
  66 </table>
  67 <hr><a name="_details"></a><h2>상세한 설명</h2>
  68 <h2><a class="anchor" name="hangulicusage">
  69 Hangul Input Context의 사용법</a></h2>
  70 이 섹션에서는 한글 입력 기능을 구현하는 핵심 기능에 대해 설명한다.<p>
  71 먼저 preedit string과 commit string 이 두 용어에 대해서 설멍하겠다. 이 두가지 용어는 Unix 계열의 입력기 framework에서 널리 쓰이는 표현이다.<p>
  72 preedit string은 아직 조합중으로 어플리케이션에 완전히 입력되지 않은 스트링을 가리킨다. 일반적으로 한글 입력기에서는 역상으로 보이고 일본 중국어 입력기에서는 underline이 붙어 나타난다. 아직 완성이 되지 않은 스트링이므로 어플리케이션에 전달이 되지 않고 사라질 수도 있다.<p>
  73 commit string은 조합이 완료되어 어플리케이션에 전달되는 스트링이다. 이 스트링은 실제 어플리케이션의 텍스트로 인식이 되므로 이 이후에는 더이상 입력기가 관리할 수 있는 데이터가 아니다.<p>
  74 한글 입력과정은 다음과 같은 과정을 거치게 된다. 입력된 영문 키를 그에 해댱하는 한글 자모로 변환한후 한글 자모를 모아 하나의 음절을 만든다. 여기까지 이루어지는 과정을 preedit string 형태로 사용자에게 계속 보이게 하는 것이 필요하다. 그리고는 한글 음절이 완성되고나면 그 글자를 어플리케이션에 commit string 형태로 보내여 입력을 완료하는 것이다. 다음 키를 받게 되면 이 과정을 반복해서 수행한다.<p>
  75 libhangul에서 한글 조합 기능은 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 이용해서 구현하게 되는데 기본 적인 방법은 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>에 사용자로부터의 입력을 순서대로 전달하면서 그 상태가 바뀜에 따라서 preedit 나 commit 스트링을 상황에 맞게 변화시키는 것이다.<p>
  76 입력 코드들은 GUI 코드와 밀접하게 붙어 있어서 키 이벤트를 받아서 처리하도록 구현하는 것이 보통이다. 그런데 유닉스에는 많은 입력 프레임웍들이 난립하고 있는 상황이어서 매 입력 프레임웍마다 한글 조합 루틴을 작성해서 넣는 것은 비효율적이다. 간단한 API를 구현하여 여러 프레임웍에서 바로 사용할 수 있도록 구현하는 편이 사용성이 높아지게 된다.<p>
  77 그래서 libhangul에서는 키 이벤트를 따로 재정의하지 않고 ASCII 코드를 직접 사용하는 방향으로 재정의된 데이터가 많지 않도록 하였다. 실제 사용 방법은 말로 설명하는 것보다 샘플 코드를 사용하는 편이 이해가 빠를 것이다. 그래서 대략적인 진행 과정을 샘플 코드로 작성하였다.<p>
  78 아래 예제는 실제로는 존재하지 않는 GUI 라이브러리 코드를 사용하였다. 실제 GUI 코드를 사용하면 코드가 너무 길어져서 설명이 어렵고 코드가 길어지면 핵심을 놓치기 쉽기 때문에 가공의 함수를 사용하였다. 또한 텍스트의 encoding conversion 관련된 부분도 생략하였다. 여기서 사용한 가공의 GUI 코드는 TWin으로 시작하게 하였다.<p>
  79 <div class="fragment"><pre class="fragment">    <a class="code" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a" title="한글 입력 상태를 관리하기 위한 오브젝트">HangulInputContext</a>* hic = <a class="code" href="group__hangulic.html#g323e53954c0fe5869ffc4cbcfc2be897" title="HangulInputContext 오브젝트를 생성한다.">hangul_ic_new</a>(<span class="stringliteral">"2"</span>);
  80     ...
  81
  82     <span class="comment">// 아래는 키 입력만 처리하는 이벤트 루프이다.</span>
  83     <span class="comment">// 실제 GUI코드는 이렇게 단순하진 않지만</span>
  84     <span class="comment">// 편의상 키 입력만 처리하는 코드로 작성하였다.</span>
  85
  86     TWinKeyEvent <span class="keyword">event</span> = TWinGetKeyEvent(); <span class="comment">// 키이벤트를 받는 이런 함수가</span>
  87                                             <span class="comment">// 있다고 치자</span>
  88     <span class="keywordflow">while</span> (ascii != 0) {
  89         <span class="keywordtype">bool</span> res;
  90         <span class="keywordflow">if</span> (event.isBackspace()) {
  91             <span class="comment">// backspace를 ascii로 변환하기가 좀 꺼림직해서</span>
  92             <span class="comment">// libhangul에서는 backspace 처리를 위한 </span>
  93             <span class="comment">// 함수를 따로 만들었다.</span>
  94             res = <a class="code" href="group__hangulic.html#g8d886ba7f2e3adb1fbc8c00d58b825b3" title="HangulInputContext가 backspace 키를 처리하도록 하는 함수">hangul_ic_backspace</a>(hic);
  95         } <span class="keywordflow">else</span> {
  96             <span class="comment">// 키 입력을 해당하는 ascii 코드로 변환한다.</span>
  97             <span class="comment">// libhangul에서는 이 ascii 코드가 키 이벤트</span>
  98             <span class="comment">// 코드와 마찬가지다.</span>
  99             <span class="keywordtype">int</span> ascii = <span class="keyword">event</span>.getAscii();
 100
 101             <span class="comment">// 키 입력을 받았으면 이것을 hic에 먼저 보낸다.</span>
 102             <span class="comment">// 그래야 hic가 이 키를 사용할 것인지 아닌지를 판단할 수 있다.</span>
 103             <span class="comment">// 함수가 true를 리턴하면 이 키를 사용했다는 의미이므로 </span>
 104             <span class="comment">// GUI 코드가 이 키 입력을 프로세싱하지 않도록 해야 한다.</span>
 105             <span class="comment">// 그렇지 않으면 한 키입력이 두번 프로세싱된다.</span>
 106             res = <a class="code" href="group__hangulic.html#g26a39855a3fb03a1f794aca464ae132e" title="키 입력을 처리하여 실제로 한글 조합을 하는 함수">hangul_ic_process</a>(hic, ascii);
 107         }
 108
 109         <span class="comment">// hic는 한번 키입력을 받고 나면 내부 상태 변화가 일어나고</span>
 110         <span class="comment">// 완성된 글자를 어플리케이션에 보내야 하는 상황이 있을 수 있다.</span>
 111         <span class="comment">// 이것을 HangulInputContext에서는 commit 스트링이 있는지로</span>
 112         <span class="comment">// 판단한다. commit 스트링을 받아봐서 스트링이 있다면 </span>
 113         <span class="comment">// 그 스트링으로 입력이 완료된 걸로 본다.</span>
 114         <span class="keyword">const</span> <a class="code" href="group__hangulctype.html#g2c1a56543786ad0dcce173493019448c" title="UCS4 코드 단위의 글자 코드 값">ucschar</a> commit;
 115         commit = <a class="code" href="group__hangulic.html#gbe09f347ac91563b4dd45f93c5bd9a03" title="현재 상태의 commit string을 구하는 함수">hangul_ic_get_commit_string</a>(hic);
 116         <span class="keywordflow">if</span> (commit[0] != 0) {   <span class="comment">// 스트링의 길이를 재서 commit 스트링이 있는지</span>
 117                                 <span class="comment">// 판단한다.</span>
 118             TWinInputUnicodeChars(commit);
 119         }
 120
 121         <span class="comment">// 키입력 후에는 preedit string도 역시 변화하게 되는데</span>
 122         <span class="comment">// 입력기 프레임웍에서는 이 스트링을 화면에 보여주어야</span>
 123         <span class="comment">// 조합중인 글자가 화면에 표시가 되는 것이다.</span>
 124         <span class="keyword">const</span> <a class="code" href="group__hangulctype.html#g2c1a56543786ad0dcce173493019448c" title="UCS4 코드 단위의 글자 코드 값">ucschar</a> preedit;
 125         preedit = <a class="code" href="group__hangulic.html#gc39496296816be4b516659b322e73d64" title="현재 상태의 preedit string을 구하는 함수">hangul_ic_get_preedit_string</a>(hic);
 126         <span class="comment">// 이 경우에는 스트링의 길이에 관계없이 항상 업데이트를 </span>
 127         <span class="comment">// 해야 한다. 왜냐하면 이전에 조합중이던 글자가 있다가</span>
 128         <span class="comment">// 조합이 완료되면서 조합중인 상태의 글자가 없어질 수도 있기 때문에</span>
 129         <span class="comment">// 스트링의 길이에 관계없이 현재 상태의 스트링을 preedit </span>
 130         <span class="comment">// 스트링으로 보여주면 되는 것이다.</span>
 131         TWinUpdatePreeditString(preedit);
 132
 133         <span class="comment">// 위 두작업이 끝난후에는 키 이벤트를 계속 프로세싱해야 하는지 </span>
 134         <span class="comment">// 아닌지를 처리해야 한다.</span>
 135         <span class="comment">// hic가 키 이벤트를 사용하지 않았다면 기본 GUI 코드에 계속해서</span>
 136         <span class="comment">// 키 이벤트 프로세싱을 진행하도록 해야 한다.</span>
 137         <span class="keywordflow">if</span> (!res)
 138             TWinForwardKeyEventToUI(ascii);
 139
 140         ascii = GetKeyEvent();
 141     }
 142
 143     <a class="code" href="group__hangulic.html#g3f153cf60e726535ad175ebb894f584d" title="HangulInputContext를 삭제하는 함수">hangul_ic_delete</a>(hic);
 144 </pre></div> <hr><h2>타입정의 문서화</h2>
 145 <a class="anchor" name="g623ec57b85ebf33279989f3e6bc2d59a"></a><!-- doxytag: member="hangul.h::HangulInputContext" ref="g623ec57b85ebf33279989f3e6bc2d59a" args="" -->
 146 <div class="memitem">
 147 <div class="memproto">
 148       <table class="memname">
 149         <tr>
 150           <td class="memname"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>          </td>
 151         </tr>
 152       </table>
 153 </div>
 154 <div class="memdoc">
 155
 156 <p>
 157 한글 입력 상태를 관리하기 위한 오브젝트
 158 <p>
 159 libhangul에서 제공하는 한글 조합 루틴에서 상태 정보를 저장하는 opaque 데이타 오브젝트이다. 이 오브젝트에 키입력 정보를 순차적으로 보내주면서 preedit 스트링이나, commit 스트링을 받아서 처리하면 한글 입력 기능을 손쉽게 구현할 수 있다. 내부의 데이터 멤버는 공개되어 있지 않다. 각각의 멤버는 accessor 함수로만 참조하여야 한다.
 160 </div>
 161 </div><p>
 162 <hr><h2>함수 문서화</h2>
 163 <a class="anchor" name="g8d886ba7f2e3adb1fbc8c00d58b825b3"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_backspace" ref="g8d886ba7f2e3adb1fbc8c00d58b825b3" args="(HangulInputContext *hic)" -->
 164 <div class="memitem">
 165 <div class="memproto">
 166       <table class="memname">
 167         <tr>
 168           <td class="memname">bool hangul_ic_backspace           </td>
 169           <td>(</td>
 170           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 171           <td class="paramname"> <em>hic</em>          </td>
 172           <td>&nbsp;)&nbsp;</td>
 173           <td width="100%"></td>
 174         </tr>
 175       </table>
 176 </div>
 177 <div class="memdoc">
 178
 179 <p>
 180 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 backspace 키를 처리하도록 하는 함수
 181 <p>
 182 <dl compact><dt><b>매개변수:</b></dt><dd>
 183   <table border="0" cellspacing="2" cellpadding="0">
 184     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 가리키는 포인터 </td></tr>
 185   </table>
 186 </dl>
 187 <dl class="return" compact><dt><b>반환값:</b></dt><dd><em>hic가</em> 키를 사용했으면 true, 사용하지 않았으면 false</dd></dl>
 188 이 함수는 <em>hic가</em> 가리키는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 조합중이던 글자를 뒤에서부터 하나 지우는 기능을 한다. backspace 키를 눌렀을 때 발생하는 동작을 한다. 따라서 이 함수를 부르고 나면 preedit string이 바뀌므로 반드시 업데이트를 해야 한다.<p>
 189 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 변화 시킨다. </dd></dl>
 190
 191 </div>
 192 </div><p>
 193 <a class="anchor" name="g3f153cf60e726535ad175ebb894f584d"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_delete" ref="g3f153cf60e726535ad175ebb894f584d" args="(HangulInputContext *hic)" -->
 194 <div class="memitem">
 195 <div class="memproto">
 196       <table class="memname">
 197         <tr>
 198           <td class="memname">void hangul_ic_delete           </td>
 199           <td>(</td>
 200           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 201           <td class="paramname"> <em>hic</em>          </td>
 202           <td>&nbsp;)&nbsp;</td>
 203           <td width="100%"></td>
 204         </tr>
 205       </table>
 206 </div>
 207 <div class="memdoc">
 208
 209 <p>
 210 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 삭제하는 함수
 211 <p>
 212 <dl compact><dt><b>매개변수:</b></dt><dd>
 213   <table border="0" cellspacing="2" cellpadding="0">
 214     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> 오브젝트</td></tr>
 215   </table>
 216 </dl>
 217 <em>hic가</em> 가리키는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> 오브젝트의 메모리를 해제한다. <a class="el" href="group__hangulic.html#g323e53954c0fe5869ffc4cbcfc2be897" title="HangulInputContext 오브젝트를 생성한다.">hangul_ic_new()</a> 함수로 생성된 모든 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> 오브젝트는 이 함수로 메모리해제를 해야 한다. 메모리 해제 과정에서 상태 변화는 일어나지 않으므로 마지막 입력된 조합중이던 내용은 사라지게 된다.
 218 </div>
 219 </div><p>
 220 <a class="anchor" name="g40e3e40e46d1554a6e2e85280396a6b5"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_flush" ref="g40e3e40e46d1554a6e2e85280396a6b5" args="(HangulInputContext *hic)" -->
 221 <div class="memitem">
 222 <div class="memproto">
 223       <table class="memname">
 224         <tr>
 225           <td class="memname">const <a class="el" href="group__hangulctype.html#g2c1a56543786ad0dcce173493019448c">ucschar</a>* hangul_ic_flush           </td>
 226           <td>(</td>
 227           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 228           <td class="paramname"> <em>hic</em>          </td>
 229           <td>&nbsp;)&nbsp;</td>
 230           <td width="100%"></td>
 231         </tr>
 232       </table>
 233 </div>
 234 <div class="memdoc">
 235
 236 <p>
 237 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 입력 상태를 완료하는 함수
 238 <p>
 239 <dl compact><dt><b>매개변수:</b></dt><dd>
 240   <table border="0" cellspacing="2" cellpadding="0">
 241     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 가리키는 포인터 </td></tr>
 242   </table>
 243 </dl>
 244 <dl class="return" compact><dt><b>반환값:</b></dt><dd>조합 완료된 스트링, 스트링의 길이가 0이면 조합 완료된 스트링이 없는 것</dd></dl>
 245 이 함수는 <em>hic가</em> 가리키는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 입력 상태를 완료한다. 조합중이던 스트링을 완성하여 리턴한다. 그리고 입력 상태가 초기 상태로 되돌아 간다. 조합중이던 글자를 강제로 commit하고 싶을때 사용하는 함수다. 보통의 경우 입력 framework에서 focus가 나갈때 이 함수를 불러서 마지막 상태를 완료해야 조합중이던 글자를 잃어버리지 않게 된다.<p>
 246 비교: <a class="el" href="group__hangulic.html#g2fa2f5972adbdacd38e1edf62ff9fc53" title="HangulInputContext를 초기상태로 되돌리는 함수">hangul_ic_reset()</a><p>
 247 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 변화 시킨다. </dd></dl>
 248
 249 </div>
 250 </div><p>
 251 <a class="anchor" name="gbe09f347ac91563b4dd45f93c5bd9a03"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_get_commit_string" ref="gbe09f347ac91563b4dd45f93c5bd9a03" args="(HangulInputContext *hic)" -->
 252 <div class="memitem">
 253 <div class="memproto">
 254       <table class="memname">
 255         <tr>
 256           <td class="memname">const <a class="el" href="group__hangulctype.html#g2c1a56543786ad0dcce173493019448c">ucschar</a>* hangul_ic_get_commit_string           </td>
 257           <td>(</td>
 258           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 259           <td class="paramname"> <em>hic</em>          </td>
 260           <td>&nbsp;)&nbsp;</td>
 261           <td width="100%"></td>
 262         </tr>
 263       </table>
 264 </div>
 265 <div class="memdoc">
 266
 267 <p>
 268 현재 상태의 commit string을 구하는 함수
 269 <p>
 270 <dl compact><dt><b>매개변수:</b></dt><dd>
 271   <table border="0" cellspacing="2" cellpadding="0">
 272     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td>commit string을 구하고자하는 입력 상태 object </td></tr>
 273   </table>
 274 </dl>
 275 <dl class="return" compact><dt><b>반환값:</b></dt><dd>UCS4 commit 스트링, 이 스트링은 <em>hic</em> 내부의 데이터이므로 수정하거나 free해서는 안된다.</dd></dl>
 276 이 함수는 <em>hic</em> 내부의 현재 상태의 commit string을 리턴한다. 따라서 hic가 다른 키 이벤트를 처리하고 나면 그 내용이 바뀔 수 있다.<p>
 277 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 변화 시키지 않는다. </dd></dl>
 278
 279 </div>
 280 </div><p>
 281 <a class="anchor" name="gc39496296816be4b516659b322e73d64"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_get_preedit_string" ref="gc39496296816be4b516659b322e73d64" args="(HangulInputContext *hic)" -->
 282 <div class="memitem">
 283 <div class="memproto">
 284       <table class="memname">
 285         <tr>
 286           <td class="memname">const <a class="el" href="group__hangulctype.html#g2c1a56543786ad0dcce173493019448c">ucschar</a>* hangul_ic_get_preedit_string           </td>
 287           <td>(</td>
 288           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 289           <td class="paramname"> <em>hic</em>          </td>
 290           <td>&nbsp;)&nbsp;</td>
 291           <td width="100%"></td>
 292         </tr>
 293       </table>
 294 </div>
 295 <div class="memdoc">
 296
 297 <p>
 298 현재 상태의 preedit string을 구하는 함수
 299 <p>
 300 <dl compact><dt><b>매개변수:</b></dt><dd>
 301   <table border="0" cellspacing="2" cellpadding="0">
 302     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td>preedit string을 구하고자하는 입력 상태 object </td></tr>
 303   </table>
 304 </dl>
 305 <dl class="return" compact><dt><b>반환값:</b></dt><dd>UCS4 preedit 스트링, 이 스트링은 <em>hic</em> 내부의 데이터이므로 수정하거나 free해서는 안된다.</dd></dl>
 306 이 함수는 <em>hic</em> 내부의 현재 상태의 preedit string을 리턴한다. 따라서 hic가 다른 키 이벤트를 처리하고 나면 그 내용이 바뀔 수 있다.<p>
 307 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 변화 시키지 않는다. </dd></dl>
 308
 309 </div>
 310 </div><p>
 311 <a class="anchor" name="gf6a03d6bf05b58cc50ed10e2c7172a33"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_has_choseong" ref="gf6a03d6bf05b58cc50ed10e2c7172a33" args="(HangulInputContext *hic)" -->
 312 <div class="memitem">
 313 <div class="memproto">
 314       <table class="memname">
 315         <tr>
 316           <td class="memname">bool hangul_ic_has_choseong           </td>
 317           <td>(</td>
 318           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 319           <td class="paramname"> <em>hic</em>          </td>
 320           <td>&nbsp;)&nbsp;</td>
 321           <td width="100%"></td>
 322         </tr>
 323       </table>
 324 </div>
 325 <div class="memdoc">
 326
 327 <p>
 328 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 초성을 가지고 있는지 확인하는 함수
 329 <p>
 330 <dl compact><dt><b>매개변수:</b></dt><dd>
 331   <table border="0" cellspacing="2" cellpadding="0">
 332     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 가리키는 포인터</td></tr>
 333   </table>
 334 </dl>
 335 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 글자가 초성이 있으면 true를 리턴한다.<p>
 336 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 변화 시키지 않는다. </dd></dl>
 337
 338 </div>
 339 </div><p>
 340 <a class="anchor" name="gcef5c615ac50da4dc99f50934739c424"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_has_jongseong" ref="gcef5c615ac50da4dc99f50934739c424" args="(HangulInputContext *hic)" -->
 341 <div class="memitem">
 342 <div class="memproto">
 343       <table class="memname">
 344         <tr>
 345           <td class="memname">bool hangul_ic_has_jongseong           </td>
 346           <td>(</td>
 347           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 348           <td class="paramname"> <em>hic</em>          </td>
 349           <td>&nbsp;)&nbsp;</td>
 350           <td width="100%"></td>
 351         </tr>
 352       </table>
 353 </div>
 354 <div class="memdoc">
 355
 356 <p>
 357 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 종성을 가지고 있는지 확인하는 함수
 358 <p>
 359 <dl compact><dt><b>매개변수:</b></dt><dd>
 360   <table border="0" cellspacing="2" cellpadding="0">
 361     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 가리키는 포인터</td></tr>
 362   </table>
 363 </dl>
 364 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 글자가 종성이 있으면 true를 리턴한다.<p>
 365 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 변화 시키지 않는다. </dd></dl>
 366
 367 </div>
 368 </div><p>
 369 <a class="anchor" name="g4509b431ce3a9c8b2b74120ea5dde9b5"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_has_jungseong" ref="g4509b431ce3a9c8b2b74120ea5dde9b5" args="(HangulInputContext *hic)" -->
 370 <div class="memitem">
 371 <div class="memproto">
 372       <table class="memname">
 373         <tr>
 374           <td class="memname">bool hangul_ic_has_jungseong           </td>
 375           <td>(</td>
 376           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 377           <td class="paramname"> <em>hic</em>          </td>
 378           <td>&nbsp;)&nbsp;</td>
 379           <td width="100%"></td>
 380         </tr>
 381       </table>
 382 </div>
 383 <div class="memdoc">
 384
 385 <p>
 386 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 중성을 가지고 있는지 확인하는 함수
 387 <p>
 388 <dl compact><dt><b>매개변수:</b></dt><dd>
 389   <table border="0" cellspacing="2" cellpadding="0">
 390     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 가리키는 포인터</td></tr>
 391   </table>
 392 </dl>
 393 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 글자가 중성이 있으면 true를 리턴한다.<p>
 394 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 변화 시키지 않는다. </dd></dl>
 395
 396 </div>
 397 </div><p>
 398 <a class="anchor" name="g392305eaf52e31967719fc039b267956"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_is_empty" ref="g392305eaf52e31967719fc039b267956" args="(HangulInputContext *hic)" -->
 399 <div class="memitem">
 400 <div class="memproto">
 401       <table class="memname">
 402         <tr>
 403           <td class="memname">bool hangul_ic_is_empty           </td>
 404           <td>(</td>
 405           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 406           <td class="paramname"> <em>hic</em>          </td>
 407           <td>&nbsp;)&nbsp;</td>
 408           <td width="100%"></td>
 409         </tr>
 410       </table>
 411 </div>
 412 <div class="memdoc">
 413
 414 <p>
 415 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 글자를 가지고 있는지 확인하는 함수
 416 <p>
 417 <dl compact><dt><b>매개변수:</b></dt><dd>
 418   <table border="0" cellspacing="2" cellpadding="0">
 419     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 가리키는 포인터</td></tr>
 420   </table>
 421 </dl>
 422 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 조합중인 글자가 있으면 true를 리턴한다.<p>
 423 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 변화 시키지 않는다. </dd></dl>
 424
 425 </div>
 426 </div><p>
 427 <a class="anchor" name="gc9e3230e98035854b806436d0569596e"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_is_transliteration" ref="gc9e3230e98035854b806436d0569596e" args="(HangulInputContext *hic)" -->
 428 <div class="memitem">
 429 <div class="memproto">
 430       <table class="memname">
 431         <tr>
 432           <td class="memname">bool hangul_ic_is_transliteration           </td>
 433           <td>(</td>
 434           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 435           <td class="paramname"> <em>hic</em>          </td>
 436           <td>&nbsp;)&nbsp;</td>
 437           <td width="100%"></td>
 438         </tr>
 439       </table>
 440 </div>
 441 <div class="memdoc">
 442
 443 <p>
 444 주어진 hic가 transliteration method인지 판별
 445 <p>
 446 <dl compact><dt><b>매개변수:</b></dt><dd>
 447   <table border="0" cellspacing="2" cellpadding="0">
 448     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td>상태를 알고자 하는 HangulInputContext 포인터 </td></tr>
 449   </table>
 450 </dl>
 451 <dl class="return" compact><dt><b>반환값:</b></dt><dd>hic가 transliteration method인 경우 true를 리턴, 아니면 false</dd></dl>
 452 이 함수는 <em>hic</em> 가 transliteration method인지 판별하는 함수다. 이 함수가 false를 리턴할 경우에는 process 함수에 keycode를 넘기기 전에 키보드 자판 배열에 독립적인 값으로 변환한 후 넘겨야 한다. 그렇지 않으면 유럽어 자판과 한국어 자판을 같이 쓸때 한글 입력이 제대로 되지 않는다.
 453 </div>
 454 </div><p>
 455 <a class="anchor" name="g323e53954c0fe5869ffc4cbcfc2be897"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_new" ref="g323e53954c0fe5869ffc4cbcfc2be897" args="(const char *keyboard)" -->
 456 <div class="memitem">
 457 <div class="memproto">
 458       <table class="memname">
 459         <tr>
 460           <td class="memname"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>* hangul_ic_new           </td>
 461           <td>(</td>
 462           <td class="paramtype">const char *&nbsp;</td>
 463           <td class="paramname"> <em>keyboard</em>          </td>
 464           <td>&nbsp;)&nbsp;</td>
 465           <td width="100%"></td>
 466         </tr>
 467       </table>
 468 </div>
 469 <div class="memdoc">
 470
 471 <p>
 472 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> 오브젝트를 생성한다.
 473 <p>
 474 <dl compact><dt><b>매개변수:</b></dt><dd>
 475   <table border="0" cellspacing="2" cellpadding="0">
 476     <tr><td valign="top"></td><td valign="top"><em>keyboard</em>&nbsp;</td><td>사용하고자 하는 키보드, 사용 가능한 값에 대해서는 <a class="el" href="group__hangulic.html#g7dd66ed8f04fe95ff401f2b29e10db1f" title="HangulInputContext의 자판 배열을 바꾸는 함수">hangul_ic_select_keyboard()</a> 함수 설명을 참조한다. </td></tr>
 477   </table>
 478 </dl>
 479 <dl class="return" compact><dt><b>반환값:</b></dt><dd>새로 생성된 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>에 대한 포인터</dd></dl>
 480 이 함수는 한글 조합 기능을 제공하는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> 오브젝트를 생성한다. 생성할때 지정한 자판은 나중에 <a class="el" href="group__hangulic.html#g7dd66ed8f04fe95ff401f2b29e10db1f" title="HangulInputContext의 자판 배열을 바꾸는 함수">hangul_ic_select_keyboard()</a> 함수로 다른 자판으로 변경이 가능하다. 더이상 사용하지 않을 때에는 <a class="el" href="group__hangulic.html#g3f153cf60e726535ad175ebb894f584d" title="HangulInputContext를 삭제하는 함수">hangul_ic_delete()</a> 함수로 삭제해야 한다.
 481 </div>
 482 </div><p>
 483 <a class="anchor" name="g26a39855a3fb03a1f794aca464ae132e"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_process" ref="g26a39855a3fb03a1f794aca464ae132e" args="(HangulInputContext *hic, int ascii)" -->
 484 <div class="memitem">
 485 <div class="memproto">
 486       <table class="memname">
 487         <tr>
 488           <td class="memname">bool hangul_ic_process           </td>
 489           <td>(</td>
 490           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 491           <td class="paramname"> <em>hic</em>, </td>
 492         </tr>
 493         <tr>
 494           <td class="paramkey"></td>
 495           <td></td>
 496           <td class="paramtype">int&nbsp;</td>
 497           <td class="paramname"> <em>ascii</em></td><td>&nbsp;</td>
 498         </tr>
 499         <tr>
 500           <td></td>
 501           <td>)</td>
 502           <td></td><td></td><td width="100%"></td>
 503         </tr>
 504       </table>
 505 </div>
 506 <div class="memdoc">
 507
 508 <p>
 509 키 입력을 처리하여 실제로 한글 조합을 하는 함수
 510 <p>
 511 <dl compact><dt><b>매개변수:</b></dt><dd>
 512   <table border="0" cellspacing="2" cellpadding="0">
 513     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> 오브젝트 </td></tr>
 514     <tr><td valign="top"></td><td valign="top"><em>ascii</em>&nbsp;</td><td>키 이벤트 </td></tr>
 515   </table>
 516 </dl>
 517 <dl class="return" compact><dt><b>반환값:</b></dt><dd><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>가 이 키를 사용했으면 true, 사용하지 않았으면 false</dd></dl>
 518 ascii 값으로 주어진 키 이벤트를 받아서 내부의 한글 조합 상태를 변화시키고, preedit, commit 스트링을 저장한다.<p>
 519 libhangul의 키 이벤트 프로세스는 ASCII 코드 값을 기준으로 처리한다. 이 키 값은 US Qwerty 자판 배열에서의 키 값에 해당한다. 따라서 유럽어 자판을 사용하는 경우에는 해당 키의 ASCII 코드를 직접 전달하면 안되고, 그 키가 US Qwerty 자판이었을 경우에 발생할 수 있는 ASCII 코드 값을 주어야 한다. 또한 ASCII 코드 이므로 Shift 상태는 대문자로 전달이 된다. Capslock이 눌린 경우에는 대소문자를 뒤바꾸어 보내주지 않으면 마치 Shift가 눌린 것 처럼 동작할 수 있으므로 주의한다. preedit, commit 스트링은 <a class="el" href="group__hangulic.html#gc39496296816be4b516659b322e73d64" title="현재 상태의 preedit string을 구하는 함수">hangul_ic_get_preedit_string()</a>, <a class="el" href="group__hangulic.html#gbe09f347ac91563b4dd45f93c5bd9a03" title="현재 상태의 commit string을 구하는 함수">hangul_ic_get_commit_string()</a> 함수를 이용하여 구할 수 있다.<p>
 520 이 함수의 사용법에 대한 설명은 <a class="el" href="group__hangulic.html#hangulicusage">Hangul Input Context의 사용법</a> 부분을 참조한다.<p>
 521 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 변화 시킨다. </dd></dl>
 522
 523 </div>
 524 </div><p>
 525 <a class="anchor" name="g2fa2f5972adbdacd38e1edf62ff9fc53"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_reset" ref="g2fa2f5972adbdacd38e1edf62ff9fc53" args="(HangulInputContext *hic)" -->
 526 <div class="memitem">
 527 <div class="memproto">
 528       <table class="memname">
 529         <tr>
 530           <td class="memname">void hangul_ic_reset           </td>
 531           <td>(</td>
 532           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 533           <td class="paramname"> <em>hic</em>          </td>
 534           <td>&nbsp;)&nbsp;</td>
 535           <td width="100%"></td>
 536         </tr>
 537       </table>
 538 </div>
 539 <div class="memdoc">
 540
 541 <p>
 542 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 초기상태로 되돌리는 함수
 543 <p>
 544 <dl compact><dt><b>매개변수:</b></dt><dd>
 545   <table border="0" cellspacing="2" cellpadding="0">
 546     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>를 가리키는 포인터</td></tr>
 547   </table>
 548 </dl>
 549 이 함수는 <em>hic가</em> 가리키는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 처음 상태로 되돌린다. preedit 스트링, commit 스트링, flush 스트링이 없어지고, 입력되었던 키에 대한 기록이 없어진다. 영어 상태로 바뀌는 것이 아니다.<p>
 550 비교: <a class="el" href="group__hangulic.html#g40e3e40e46d1554a6e2e85280396a6b5" title="HangulInputContext의 입력 상태를 완료하는 함수">hangul_ic_flush()</a><p>
 551 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 상태를 변화 시킨다. </dd></dl>
 552
 553 </div>
 554 </div><p>
 555 <a class="anchor" name="g7dd66ed8f04fe95ff401f2b29e10db1f"></a><!-- doxytag: member="hangulinputcontext.c::hangul_ic_select_keyboard" ref="g7dd66ed8f04fe95ff401f2b29e10db1f" args="(HangulInputContext *hic, const char *id)" -->
 556 <div class="memitem">
 557 <div class="memproto">
 558       <table class="memname">
 559         <tr>
 560           <td class="memname">void hangul_ic_select_keyboard           </td>
 561           <td>(</td>
 562           <td class="paramtype"><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> *&nbsp;</td>
 563           <td class="paramname"> <em>hic</em>, </td>
 564         </tr>
 565         <tr>
 566           <td class="paramkey"></td>
 567           <td></td>
 568           <td class="paramtype">const char *&nbsp;</td>
 569           <td class="paramname"> <em>id</em></td><td>&nbsp;</td>
 570         </tr>
 571         <tr>
 572           <td></td>
 573           <td>)</td>
 574           <td></td><td></td><td width="100%"></td>
 575         </tr>
 576       </table>
 577 </div>
 578 <div class="memdoc">
 579
 580 <p>
 581 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 자판 배열을 바꾸는 함수
 582 <p>
 583 <dl compact><dt><b>매개변수:</b></dt><dd>
 584   <table border="0" cellspacing="2" cellpadding="0">
 585     <tr><td valign="top"></td><td valign="top"><em>hic</em>&nbsp;</td><td><a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a> 오브젝트 </td></tr>
 586     <tr><td valign="top"></td><td valign="top"><em>id</em>&nbsp;</td><td>선택하고자 하는 자판, 아래와 같은 값을 선택할 수 있다. <ul>
 587 <li>"2" 두벌식 자판 </li>
 588 <li>"32" 세벌식 자판으로 두벌식의 배열을 가진 자판. 두벌식 사용자가 쉽게 세벌식 테스트를 할 수 있다. shift를 누르면 자음이 종성으로 동작한다. </li>
 589 <li>"3f" 세벌식 최종 </li>
 590 <li>"39" 세벌식 390 </li>
 591 <li>"3s" 세벌식 순아래 </li>
 592 <li>"3y" 세벌식 옛글 </li>
 593 <li>"ro" 로마자 방식 자판 </li>
 594 </ul>
 595 </td></tr>
 596   </table>
 597 </dl>
 598 <dl class="return" compact><dt><b>반환값:</b></dt><dd>없음</dd></dl>
 599 이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 자판을 <em>id로</em> 지정된 것으로 변경한다.<p>
 600 <dl class="remark" compact><dt><b>Remarks:</b></dt><dd>이 함수는 <a class="el" href="group__hangulic.html#g623ec57b85ebf33279989f3e6bc2d59a">HangulInputContext</a>의 내부 조합 상태에는 영향을 미치지 않는다. 따라서 입력 중간에 자판을 변경하더라도 조합 상태는 유지된다. </dd></dl>
 601
 602 </div>
 603 </div><p>
 604 <hr size="1"><address style="text-align: right;"><small>생성시간 : Wed Nov 23 23:31:45 2011, 프로젝트명 : libhangul, 생성자 : &nbsp;
 605 <a href="http://www.doxygen.org/index.html">
 606 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.3-20071008 </small></address>
 607 </body>
 608 </html>