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>ClearHomeButtonState</title>
8  </head>
9  <body>
10<h1><CODE>nn::applet::CTR::ClearHomeButtonState</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14void ClearHomeButtonState(
15     void
16);
17</pre>
18    </div>
19<h2>Arguments</h2>
20    <div class="section">
21<p>None.</p>
22    </div>
23<h2>Return Values</h2>
24    <div class="section">
25None.
26               </div>
27<h2>Description</h2>
28    <div class="section">
29<p>Clears the HOME Button state.</p><!-- write here --><P>This clears the value obtained by calling the <CODE><a href="../../../nn/applet/CTR/GetHomeButtonState.html">nn::applet::CTR::GetHomeButtonState</a></CODE> function. In other words, it sets the state value to <CODE>nn::applet::CTR::HOME_BUTTON_NONE</CODE>.
30</P><P>
31This function also serves to notify the system of the end of exclusive control between the HOME Button transition and the POWER Button or Sleep Mode transitions.
32</P><P>
33This function must therefore be called after control returns to the application from the <a href="../../../nn/applet/CTR/WaitForStarting.html"><CODE>nn::applet::CTR::WaitForStarting</CODE></a> function. However, the application does not need to call this function because <a href="../../../nn/applet/CTR/WaitForStarting.html"><CODE>nn::applet::CTR::WaitForStarting</CODE></a> does.
34</P><P>
35Call this function when a HOME Button press is detected but not processed while the HOME Button is prohibited (disabled).
36</P><P>
37Example
38</P><PRE>
39   // HOME Button transition check
40   if ( applet::IsExpectedToProcessHomeButton() )
41   {
42       // When the HOME Button is prohibited (disabled)
43       if ( _is_suppressed_home_button() )
44       {
45          <FONT color="red">applet::ClearHomeButtonState();</FONT>
46       }
47       else
48       {
49          WaitForStarting();
50          if ( applet::IsExpectedToCloseApplication() )
51          {
52             _close_application();
53          }
54     }
55   }
56</PRE></div>
57<h2>Revision History</h2>
58    <div class="section">
59      <dl class="history">
60        <dt>2010/11/10</dt>
61<dd>Initial version.<br />
62        </dd>
63      </dl>
64    </div>
65  <hr><p>CONFIDENTIAL</p></body>
66</html>