<html> <head> <link rel="stylesheet" href="page.css" type="text/css"> <title>fox-toolkit.org - Documentation</title> </head> <body bgcolor=#ffffff link=#990033 vlink=#990033 alink=#990033 text=#000000> <font face='verdana,sans-serif' size=2 > <!---- TOPIC TITLE WITH LOGO---> <table border=0 cellpadding= cellspacing=2 width=100% ><tr><td><a href='http://www.fox-toolkit.org/doc.html'><img src='../art/foxlogo_small.jpg' border=0></a></td><td width=100% valign=bottom><font face='verdana,sans-serif' size=2 ><b> <a class="qindex" href="index.html">Main Page</a> <a class="qindex" href="hierarchy.html">Class Hierarchy</a> <a class="qindex" href="classes.html">Alphabetical List</a> <a class="qindex" href="annotated.html">Compound List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> <br><img src='../art/line.gif' width=100% height=1></b></font></td></tr></table> <p> <!--- TOPIC TITLE WITH LOGO ---> <!-- Generated by Doxygen 1.3.3 --> <h1>FX::FXInputDialog Class Reference</h1>An Input Dialog is a simple dialog which is used to obtain a text string, integer, or real number from the user. <a href="#_details">More...</a> <p> <code>#include <<a class="el" href="FXInputDialog_8h-source.html">FXInputDialog.h</a>></code> <p> <p>Inheritance diagram for FX::FXInputDialog: <p><center><img src="classFX_1_1FXInputDialog.png" usemap="#FX::FXInputDialog_map" border="0" alt=""></center> <map name="FX::FXInputDialog_map"> <area href="classFX_1_1FXDialogBox.html" alt="FX::FXDialogBox" shape="rect" coords="0,392,117,416"> <area href="classFX_1_1FXTopWindow.html" alt="FX::FXTopWindow" shape="rect" coords="0,336,117,360"> <area href="classFX_1_1FXShell.html" alt="FX::FXShell" shape="rect" coords="0,280,117,304"> <area href="classFX_1_1FXComposite.html" alt="FX::FXComposite" shape="rect" coords="0,224,117,248"> <area href="classFX_1_1FXWindow.html" alt="FX::FXWindow" shape="rect" coords="0,168,117,192"> <area href="classFX_1_1FXDrawable.html" alt="FX::FXDrawable" shape="rect" coords="0,112,117,136"> <area href="classFX_1_1FXId.html" alt="FX::FXId" shape="rect" coords="0,56,117,80"> <area href="classFX_1_1FXObject.html" alt="FX::FXObject" shape="rect" coords="0,0,117,24"> </map> <a href="classFX_1_1FXInputDialog-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0> <tr><td></td></tr> <tr><td colspan=2><br><h2>Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top> </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#a0">FXInputDialog</a> (<a class="el" href="classFX_1_1FXWindow.html">FXWindow</a> *owner, const <a class="el" href="classFX_1_1FXString.html">FXString</a> &caption, const <a class="el" href="classFX_1_1FXString.html">FXString</a> &label, <a class="el" href="classFX_1_1FXIcon.html">FXIcon</a> *ic=NULL, FXuint opts=INPUTDIALOG_STRING, FXint x=0, FXint y=0, FXint w=0, FXint h=0)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="classFX_1_1FXString.html">FXString</a> </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#a1">getText</a> () const</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#a2">setText</a> (const <a class="el" href="classFX_1_1FXString.html">FXString</a> &text)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#a3">setNumColumns</a> (FXint num)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>FXint </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#a4">getNumColumns</a> () const</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#a5">setLimits</a> (FXdouble lo, FXdouble hi)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#a6">getLimits</a> (FXdouble &lo, FXdouble &hi)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>virtual FXuint </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#a7">execute</a> (FXuint placement=PLACEMENT_CURSOR)</td></tr> <tr><td colspan=2><br><h2>Static Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>FXbool </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#e0">getString</a> (<a class="el" href="classFX_1_1FXString.html">FXString</a> &result, <a class="el" href="classFX_1_1FXWindow.html">FXWindow</a> *owner, const <a class="el" href="classFX_1_1FXString.html">FXString</a> &caption, const <a class="el" href="classFX_1_1FXString.html">FXString</a> &label, <a class="el" href="classFX_1_1FXIcon.html">FXIcon</a> *ic=NULL)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>FXbool </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#e1">getInteger</a> (FXint &result, <a class="el" href="classFX_1_1FXWindow.html">FXWindow</a> *owner, const <a class="el" href="classFX_1_1FXString.html">FXString</a> &caption, const <a class="el" href="classFX_1_1FXString.html">FXString</a> &label, <a class="el" href="classFX_1_1FXIcon.html">FXIcon</a> *ic=NULL, FXint lo=1, FXint hi=0)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>FXbool </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXInputDialog.html#e2">getReal</a> (FXdouble &result, <a class="el" href="classFX_1_1FXWindow.html">FXWindow</a> *owner, const <a class="el" href="classFX_1_1FXString.html">FXString</a> &caption, const <a class="el" href="classFX_1_1FXString.html">FXString</a> &label, <a class="el" href="classFX_1_1FXIcon.html">FXIcon</a> *ic=NULL, FXdouble lo=1.0, FXdouble hi=0.0)</td></tr> </table> <hr><a name="_details"></a><h2>Detailed Description</h2> An Input Dialog is a simple dialog which is used to obtain a text string, integer, or real number from the user. <p> A password mode allows the key-in to remain hidden.<p> See also: <ul> <li><a class="el" href="group__FXInputDialog__0.html">Input dialog options</a>. </li> </ul> <p> <hr><h2>Constructor & Destructor Documentation</h2> <a name="a0" doxytag="FX::FXInputDialog::FXInputDialog"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> FX::FXInputDialog::FXInputDialog </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="classFX_1_1FXWindow.html">FXWindow</a> * </td> <td class="mdname" nowrap> <em>owner</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>caption</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>label</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap><a class="el" href="classFX_1_1FXIcon.html">FXIcon</a> * </td> <td class="mdname" nowrap> <em>ic</em> = NULL, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXuint </td> <td class="mdname" nowrap> <em>opts</em> = INPUTDIALOG_STRING, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXint </td> <td class="mdname" nowrap> <em>x</em> = 0, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXint </td> <td class="mdname" nowrap> <em>y</em> = 0, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXint </td> <td class="mdname" nowrap> <em>w</em> = 0, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXint </td> <td class="mdname" nowrap> <em>h</em> = 0</td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Construct input dialog box with given caption, icon, and prompt text. <p> </td> </tr> </table> <hr><h2>Member Function Documentation</h2> <a name="a1" doxytag="FX::FXInputDialog::getText"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> <a class="el" href="classFX_1_1FXString.html">FXString</a> FX::FXInputDialog::getText </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> const</td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Get input string. <p> </td> </tr> </table> <a name="a2" doxytag="FX::FXInputDialog::setText"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXInputDialog::setText </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname1" valign="top" nowrap> <em>text</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Set input string. <p> </td> </tr> </table> <a name="a3" doxytag="FX::FXInputDialog::setNumColumns"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXInputDialog::setNumColumns </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">FXint </td> <td class="mdname1" valign="top" nowrap> <em>num</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Change number of visible columns of text. <p> </td> </tr> </table> <a name="a4" doxytag="FX::FXInputDialog::getNumColumns"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> FXint FX::FXInputDialog::getNumColumns </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> const</td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Return number of visible columns of text. <p> </td> </tr> </table> <a name="a5" doxytag="FX::FXInputDialog::setLimits"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXInputDialog::setLimits </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">FXdouble </td> <td class="mdname" nowrap> <em>lo</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXdouble </td> <td class="mdname" nowrap> <em>hi</em></td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"><code> [inline]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Change limits. <p> </td> </tr> </table> <a name="a6" doxytag="FX::FXInputDialog::getLimits"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXInputDialog::getLimits </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">FXdouble & </td> <td class="mdname" nowrap> <em>lo</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXdouble & </td> <td class="mdname" nowrap> <em>hi</em></td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"><code> [inline]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Return limits. <p> </td> </tr> </table> <a name="a7" doxytag="FX::FXInputDialog::execute"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> virtual FXuint FX::FXInputDialog::execute </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">FXuint </td> <td class="mdname1" valign="top" nowrap> <em>placement</em> = PLACEMENT_CURSOR </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap><code> [virtual]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Run modal invocation of the dialog. <p> <p> Reimplemented from <a class="el" href="classFX_1_1FXDialogBox.html#a2">FX::FXDialogBox</a>. </td> </tr> </table> <a name="e0" doxytag="FX::FXInputDialog::getString"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> FXbool FX::FXInputDialog::getString </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>result</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap><a class="el" href="classFX_1_1FXWindow.html">FXWindow</a> * </td> <td class="mdname" nowrap> <em>owner</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>caption</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>label</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap><a class="el" href="classFX_1_1FXIcon.html">FXIcon</a> * </td> <td class="mdname" nowrap> <em>ic</em> = NULL</td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"><code> [static]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Prompt for a string, start with the initial value. <p> Return TRUE if the new value is accepted, and false otherwise. </td> </tr> </table> <a name="e1" doxytag="FX::FXInputDialog::getInteger"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> FXbool FX::FXInputDialog::getInteger </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">FXint & </td> <td class="mdname" nowrap> <em>result</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap><a class="el" href="classFX_1_1FXWindow.html">FXWindow</a> * </td> <td class="mdname" nowrap> <em>owner</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>caption</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>label</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap><a class="el" href="classFX_1_1FXIcon.html">FXIcon</a> * </td> <td class="mdname" nowrap> <em>ic</em> = NULL, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXint </td> <td class="mdname" nowrap> <em>lo</em> = 1, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXint </td> <td class="mdname" nowrap> <em>hi</em> = 0</td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"><code> [static]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Prompt for an integer number, start with the given initial value. <p> Return TRUE if the new value is accepted, and false otherwise. The input is constrained between lo and hi, unless lo>hi, in which case the input can be any number. </td> </tr> </table> <a name="e2" doxytag="FX::FXInputDialog::getReal"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> FXbool FX::FXInputDialog::getReal </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">FXdouble & </td> <td class="mdname" nowrap> <em>result</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap><a class="el" href="classFX_1_1FXWindow.html">FXWindow</a> * </td> <td class="mdname" nowrap> <em>owner</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>caption</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>label</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap><a class="el" href="classFX_1_1FXIcon.html">FXIcon</a> * </td> <td class="mdname" nowrap> <em>ic</em> = NULL, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXdouble </td> <td class="mdname" nowrap> <em>lo</em> = 1.0, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXdouble </td> <td class="mdname" nowrap> <em>hi</em> = 0.0</td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"><code> [static]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Prompt for an real number, start with the given initial value. <p> Return TRUE if the new value is accepted, and false otherwise. The input is constrained between lo and hi, unless lo>hi, in which case the input can be any number. </td> </tr> </table> </font> <!--- COPYRIGHT --> <p> <table width=100% cellpadding=0 cellspacing=0><tr><td width=100% valign=top id=HEADLINE align=right> <img src='../art/line.gif' width=100% height=1><font size=-1> Copyright © 1997-2004 Jeroen van der Zijp</font> </td></tr></table> </p> <!--- COPYRIGHT --> </body> </html>