Sancho at 16:58, 2 September 2011

2011-09-02T16:58:54Z

Sancho: moved EN/documentation/basic guide/message and input boxes (runtime library) to EN/documentation/basic guide/message and input boxes runtime library

2011-09-02T16:53:48Z

moved EN/documentation/basic guide/message and input boxes (runtime library) to EN/documentation/basic guide/message and input boxes runtime library

Sancho: Основной текст

2011-09-02T10:53:14Z

Основной текст

New page

<section begin=title /><noinclude>{{DISPLAYTITLE:</noinclude>Message and Input Boxes ({{OOo}} Runtime Library)<noinclude>}}</noinclude><section end=title />{{BreadCrumbL10n}}

{{Documentation/BASICGuideTOC
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=EN/documentation/basic_guide/files_and_directories_(runtime_library)
|NextPage=EN/documentation/basic_guide/other_functions_(runtime_library)
|runtime=block
}}

{{OOo}} Basic provides the <tt>MsgBox</tt> and <tt>InputBox</tt> functions for basic user communication.

== Displaying Messages ==
<tt>MsgBox</tt> displays a basic information box, which can have one or more buttons. In its simplest variant the <tt>MsgBox</tt> only contains text and an OK button:

<source lang="oobas">
MsgBox "This is a piece of information!"
</source>

The appearance of the information box can be changed using a parameter. The parameter provides the option of adding additional buttons, defining the pre-assigned button, and adding an information symbol.
{{Note|By convention, the symbolic names given below are written in UPPERCASE, to mark them as predefined, rather than user-defined. However, the names are not case-sensitive.}}
The values for selecting the buttons are:

* <tt>0, MB_OK</tt> - OK button
* <tt>1, MB_OKCANCEL</tt> - OK and Cancel button
* <tt>2, MB_ABORTRETRYIGNORE</tt> - Abort, Retry, and Ignore buttons
* <tt>3, MB_YESNOCANCEL</tt> - Yes, No, and Cancel buttons
* <tt>4, MB_YESNO</tt> - Yes and No buttons
* <tt>5, MB_RETRYCANCEL</tt> - Retry and Cancel buttons

To set a button as the default button, add one of the following values to the parameter value from the list of button selections. For example, to create Yes, No and Cancel buttons (value 3) where Cancel is the default (value 512), the parameter value is 3 + 512 = 515. The expression <tt>MB_YESNOCANCEL + MB_DEFBUTTON3</tt> is harder to write, but easier to understand.

* <tt>0, MB_DEFBUTTON1</tt> - First button is default value
* <tt>256, MB_DEFBUTTON2</tt> - Second button is default value
* <tt>512, MB_DEFBUTTON3</tt> - Third button is default value

Finally, the following information symbols are available and can also be displayed by adding the relevant parameter values:

* <tt>16, MB_ICONSTOP</tt> - Stop sign
* <tt>32, MB_ICONQUESTION</tt> - Question mark
* <tt>48, MB_ICONEXCLAMATION</tt> - Exclamation point
* <tt>64, MB_ICONINFORMATION</tt> - Tip icon

The following call displays an information box with the Yes and No buttons (value 4), of which the second button (No) is set as the default value (value 256) and which also receives a question mark (value 32), 4+256+32=292.

<source lang="oobas">
MsgBox "Do you want to continue?", 292
' or,
MsgBox "Do you want to continue?", MB_YESNO + MB_DEFBUTTON2 + MB_ICONQUESTION
</source>
[[Image:MsgBox292.png|300px|none|thumb|Display of the Message Box]]

If an information box contains several buttons, then a return value should be queried to determine which button has been pressed. The following return values are available in this instance:

* <tt>1, IDOK</tt> - Ok
* <tt>2, IDCANCEL</tt> - Cancel
* <tt>3, IDABORT</tt> - Abort
* <tt>4, IDRETRY</tt> - Retry
* <tt>5</tt> - Ignore
* <tt>6, IDYES</tt> - Yes
* <tt>7, IDNO</tt> - No

In the previous example, checking the return values could be as follows:

<source lang="oobas">
Dim iBox as Integer
iBox = MB_YESNO + MB_DEFBUTTON2 + MB_ICONQUESTION
If MsgBox ("Do you want to continue?", iBox) = IDYES Then
' or,
If MsgBox ("Do you want to continue?", 292) = 6 Then
' Yes button pressed
Else
' No button pressed
End IF
</source>

In addition to the information text and the parameter for arranging the information box, <tt>MsgBox</tt> also permits a third parameter, which defines the text for the box title:

<source lang="oobas">
MsgBox "Do you want to continue?", 292, "Box Title"
</source>

If no box title is specified, the default is “soffice”.

== Input Box For Querying Simple Strings ==

The <tt>InputBox</tt> function queries simple strings from the user. It is therefore a simple alternative to configuring dialogs. <tt>InputBox</tt> receives three standard parameters:

* An information text.
* A box title.
* A default value which can be added within the input area.

<source lang="oobas">
InputVal = InputBox("Please enter value:", "Test", "default value")
</source>
[[Image:InputBoxTest.png|600px|none|thumb|Display of the Input Box]]

* The dimensions of the <tt>InputBox</tt> window cannot be changed.
* If the user clicks the OK button, the <tt>InputBox</tt> returns the string typed by the user (or the default string if it was not changed).
* If the user clicks the Cancel button or closes the window, the <tt>InputBox</tt> returns an empty string.

{{PDL1}}

@@ Line 5: / Line 5: @@
 |ShowPrevNext=block
 |ShowPrevPage=block
-|PrevPage=EN/documentation/basic_guide/files_and_directories_(runtime_library)
+|PrevPage=EN/documentation/basic_guide/files_and_directories_runtime_library
-|NextPage=EN/documentation/basic_guide/other_functions_(runtime_library)
+|NextPage=EN/documentation/basic_guide/other_functions_runtime_library
 |runtime=block
 }}

← Older revision	Revision as of 16:53, 2 September 2011
(No difference)

EN/documentation/basic guide/message and input boxes runtime library - Revision history

Sancho at 16:58, 2 September 2011

Sancho: moved EN/documentation/basic guide/message and input boxes (runtime library) to EN/documentation/basic guide/message and input boxes runtime library

Sancho: Основной текст