From 759025310872d7c8ad6d360e15ec4af55e7012ac Mon Sep 17 00:00:00 2001
From: Pierre F
Date: Sat, 3 Aug 2024 10:34:30 +0200
Subject: MsgBox not a Statement. tdf#162447
originally from https://ask.libreoffice.org/t/msgbox-statement-vs-function/108929
Change-Id: I62e871b878ec463e9d82a7506124a5c99de7ac28
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/171415
Tested-by: Jenkins
Reviewed-by: Olivier Hallot
---
source/text/sbasic/shared/03/sf_basic.xhp | 2 +-
source/text/sbasic/shared/03010100.xhp | 1 -
source/text/sbasic/shared/03010101.xhp | 227 ---------------------------
source/text/sbasic/shared/03010102.xhp | 247 +++++++++++++++++++++++++-----
source/text/sbasic/shared/03040000.xhp | 2 +-
source/text/sbasic/shared/03103600.xhp | 2 +-
6 files changed, 210 insertions(+), 271 deletions(-)
delete mode 100644 source/text/sbasic/shared/03010101.xhp
(limited to 'source/text/sbasic')
diff --git a/source/text/sbasic/shared/03/sf_basic.xhp b/source/text/sbasic/shared/03/sf_basic.xhp
index bb4f814a7b..67c2fcc94a 100644
--- a/source/text/sbasic/shared/03/sf_basic.xhp
+++ b/source/text/sbasic/shared/03/sf_basic.xhp
@@ -594,7 +594,7 @@
bas.MsgBox(prompt: str, [buttons: int], [title: str])[: int]
-
+
An optional integer as detailed in above IDxx properties.
diff --git a/source/text/sbasic/shared/03010100.xhp b/source/text/sbasic/shared/03010100.xhp
index bf15be4633..8fc93123bf 100644
--- a/source/text/sbasic/shared/03010100.xhp
+++ b/source/text/sbasic/shared/03010100.xhp
@@ -36,7 +36,6 @@
Display Functions
This section describes Runtime functions used to output information to the screen display.
-
-
-
+MsgBox function
-
-
MsgBox Function
-Displays a dialog box containing a message and returns a value.
+
MsgBox Function
+Displays a dialog box containing a message and returns a value.
@@ -43,114 +41,283 @@
MsgBox (Prompt As String [,Buttons = MB_OK [,Title As String]]) As Integer
-
+
+
+
+prompt: String expression displayed as a message in the dialog box. Line breaks can be inserted with Chr$(13).
+title: String expression displayed in the title bar of the dialog. If omitted, the title bar displays the name of the respective application.
+buttons: Any integer expression that specifies the dialog type, as well as the number and type of buttons to display, and the icon type. buttons represents a combination of bit patterns, that is, a combination of elements can be defined by adding their respective values:
+
+
+
+
+
+
+
+ Named constant
+
+
+ Integer value
+
+
+ Definition
+
+
+
+
+ MB_OK
+
+
+ 0
+
+
+ Display OK button only.
+
+
+
+
+ MB_OKCANCEL
+
+
+ 1
+
+
+ Display OK and Cancel buttons.
+
+
+
+
+ MB_ABORTRETRYIGNORE
+
+
+ 2
+
+
+ Display Abort, Retry, and Ignore buttons.
+
+
+
+
+ MB_YESNOCANCEL
+
+
+ 3
+
+
+ Display Yes, No, and Cancel buttons.
+
+
+
+
+ MB_YESNO
+
+
+ 4
+
+
+ Display Yes and No buttons.
+
+
+
+
+ MB_RETRYCANCEL
+
+
+ 5
+
+
+ Display Retry and Cancel buttons.
+
+
+
+
+ MB_ICONSTOP
+
+
+ 16
+
+
+ Add the Stop icon to the dialog.
+
+
+
+
+ MB_ICONQUESTION
+
+
+ 32
+
+
+ Add the Question icon to the dialog.
+
+
+
+
+ MB_ICONEXCLAMATION
+
+
+ 48
+
+
+ Add the Exclamation Point icon to the dialog.
+
+
+
+
+ MB_ICONINFORMATION
+
+
+ 64
+
+
+ Add the Information icon to the dialog.
+
+
+
+
+
+
+
+ 128
+
+
+ First button in the dialog as default button.
+
+
+
+
+ MB_DEFBUTTON2
+
+
+ 256
+
+
+ Second button in the dialog as default button.
+
+
+
+
+ MB_DEFBUTTON3
+
+
+ 512
+
+
+ Third button in the dialog as default button.
+
+
+