X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/0180dad680ecbe4cb5cf8e6e45ce569f7a1029f7..8e124873c5bd39ba8e9cc3c05ac7e4c97fbe59cd:/docs/latex/wx/function.tex diff --git a/docs/latex/wx/function.tex b/docs/latex/wx/function.tex index bb08c1b42d..788836a1a7 100644 --- a/docs/latex/wx/function.tex +++ b/docs/latex/wx/function.tex @@ -405,6 +405,27 @@ parameters are optional. However, it is recommended to pass a parent frame parameter, or (in MS Windows or Motif) the wrong window frame may be brought to the front when the dialog box is popped up. +\membersection{::wxCreateFileTipProvider}\label{wxcreatefiletipprovider} + +\func{wxTipProvider *}{wxCreateFileTipProvider}{ + \param{const wxString\& }{filename}, + \param{size\_t }{currentTip}} + +This function creates a \helpref{wxTipProvider}{wxtipprovider} which may be +used with \helpref{wxShowTip}{wxshowtip}. + +\docparam{filename}{The name of the file containing the tips, one per line} +\docparam{currentTip}{The index of the first tip to show - normally this index + is remembered between the 2 program runs.} + +\wxheading{See also:} + +\helpref{Tips overview}{tipsoverview} + +\wxheading{Include files} + + + \membersection{::wxFileSelector}\label{wxfileselector} \func{wxString}{wxFileSelector}{\param{const wxString\& }{message}, \param{const wxString\& }{default\_path = ""},\\ @@ -451,6 +472,33 @@ if (s) +\membersection{::wxGetNumberFromUser}\label{wxgetnumberfromuser} + +\func{long}{wxGetNumberFromUser}{ + \param{const wxString\& }{message}, + \param{const wxString\& }{prompt}, + \param{const wxString\& }{caption}, + \param{long }{value}, + \param{long }{min = 0}, + \param{long }{max = 100}, + \param{wxWindow *}{parent = NULL}, + \param{const wxPoint\& }{pos = wxDefaultPosition}} + +Shows a dialog asking the user for numeric input. The dialogs title is set to +{\it caption}, it contains a (possibly) multiline {\it message} above the +single line {\it prompt} and the zone for entering the number. + +The number entered must be in the range {\it min}..{\it max} (both of which +should be positive) and {\it value} is the initial value of it. If the user +enters an invalid value or cancels the dialog, the function will return -1. + +Dialog is centered on its {\it parent} unless an explicit position is given in +{\it pos}. + +\wxheading{Include files} + + + \membersection{::wxGetTextFromUser}\label{wxgettextfromuser} \func{wxString}{wxGetTextFromUser}{\param{const wxString\& }{message}, \param{const wxString\& }{caption = ``Input text"},\\ @@ -585,6 +633,33 @@ The symbols are not shown when the generic function is used. +\membersection{::wxShowTip}\label{wxshowtip} + +\func{bool}{wxShowTip}{ + \param{wxWindow *}{parent}, + \param{wxTipProvider *}{tipProvider}, + \param{bool }{showAtStartup = TRUE}} + +This function shows a "startup tip" to the user. + +\docparam{parent}{The parent window for the modal dialog} + +\docparam{tipProvider}{An object which is used to get the text of the tips. + It may be created with + \helpref{wxCreateFileTipProvider}{wxcreatefiletipprovider} function.} + +\docparam{showAtStartup}{Should be TRUE if startup tips are shown, FALSE + otherwise. This is used as the initial value for "Show tips at startup" + checkbox which is shown in the tips dialog.} + +\wxheading{See also:} + +\helpref{Tips overview}{tipsoverview} + +\wxheading{Include files} + + + \section{GDI functions}\label{gdifunctions} The following are relevant to the GDI (Graphics Device Interface). @@ -637,11 +712,13 @@ This function is only available under Windows. \func{void}{wxSetCursor}{\param{wxCursor *}{cursor}} -Globally sets the cursor; only has an effect in MS Windows. +Globally sets the cursor; only has an effect in Windows and GTK. See also \helpref{wxCursor}{wxcursor}, \helpref{wxWindow::SetCursor}{wxwindowsetcursor}. \section{Printer settings}\label{printersettings} +These routines are obsolete and should no longer be used! + The following functions are used to control PostScript printing. Under Windows, PostScript output can only be sent to a file.