1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../css/manpage.css" type="text/css" />
7    <title>AppTextCheckCallback</title>
8  </head>
9  <body>
10    <h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/swkbd/Overview.html">swkbd</a>::<a href="../../../nn/swkbd/CTR/Overview.html">CTR</a>::AppTextCheckCallback</CODE> Type</h1>
11    <h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14typedef <a href="../../../nn/swkbd/CTR/AppTextCheckResult.html">AppTextCheckResult</a>(* nn::swkbd::CTR::AppTextCheckCallback)(const wchar_t **ppDialogText, const wchar_t *pInputText, u16 inputTextLength);</pre>
15    </div>
16    <h2>Arguments</h2>
17    <div class="section">
18      <table class="arguments">
19        <thead>
20          <tr>
21            <td width="15" />
22            <th>Name</th>
23            <td>Description</td>
24          </tr>
25        </thead>
26        <tr>
27          <td>out</td>
28          <th><CODE>ppDialogText</CODE></th>
29          <td>The starting address of the <CODE>NULL</CODE>-terminated string to show on the dialog.</td>
30        </tr>
31        <tr>
32          <td>in</td>
33          <th><CODE>pInputText</CODE></th>
34          <td>The starting address of the entered string.</td>
35        </tr>
36        <tr>
37          <td>in</td>
38          <th><CODE>inputTextLength</CODE></th>
39          <td>Length of the entered string.</td>
40        </tr> </table>
41    </div>
42    <h2>Description</h2>
43    <div class="section">
44      <p>Function type representing the callback for text checking performed by the application.</p><p>When text checking by the application is enabled&mdash;in other words, when the <CODE>TEXT_CHECK_APP</CODE> flag is set in the <CODE>textCheckFlag</CODE> member variable of the <a href="../../../nn/swkbd/CTR/Config/Overview.html"><CODE>nn::swkbd::CTR::Config</CODE></a> structure&mdash;this is the callback function invoked when the users finalize their input. The callback function is set by the <a href="../../../nn/swkbd/CTR/StartKeyboardApplet.html"><CODE>nn::swkbd::CTR::StartKeyboardApplet</CODE></a> function.</p><p>The starting address of the user's text input is given by the <span class="argument">pInputText</span> argument and the length of the string is given by the <span class="argument">inputTextLength</span> argument. Return the result of the text check as a <a href="../../../nn/swkbd/CTR/AppTextCheckResult.html"><CODE>nn::swkbd::CTR::AppTextCheckResult</CODE></a>-type value.</p><p>If the result of the text check is anything other than <CODE>APP_TEXT_CHECK_RESULT_OK</CODE>, store the starting address of the string to display in the dialog in the <span class="argument">ppDialogText</span> parameter.<br /> This string must be no longer than <CODE><a href="../../../nn/swkbd/CTR/APP_TEXT_CHECK_DIALOG_TEXT_LENGTH_MAX.html">nn::swkbd::CTR::APP_TEXT_CHECK_DIALOG_TEXT_LENGTH_MAX</a></CODE> and must be null-terminated.<br /> When the result is <CODE>APP_TEXT_CHECK_RESULT_OK</CODE>, this process is not needed.</p></div>
45    <h2>Revision History</h2>
46    <div class="section">
47      <dl class="history">
48        <dt>2011/03/01</dt>
49        <dd>Initial version.<br />
50        </dd>
51      </dl>
52    </div>
53  <hr><p>CONFIDENTIAL</p></body>
54</html>
55