Show - Message/uk

Член: Message Script (en)

Відображає повідомлення на екрані, підставляючи передані числа у відповідні місця в тексті. Якщо повідомлення налаштовано для відображення в діалоговому вікні, функція очікує, поки користувач натисне кнопку, і повертає, яку саме кнопку було натиснуто.

Синтаксис

int Function Show(float afArg1 = 0.0, float afArg2 = 0.0, float afArg3 = 0.0, float afArg4 = 0.0, float afArg5 = 0.0,
    float afArg6 = 0.0, float afArg7 = 0.0, float afArg8 = 0.0, float afArg9 = 0.0) native

Параметри

• afArg1: число, яке треба підставити в якості першого аргументу в тексті.
  • За замовчуванням: 0.0
• afArg2: число, яке треба підставити в якості другого аргументу в тексті.
  • За замовчуванням: 0.0
• afArg3: число, яке треба підставити в якості третього аргументу в тексті.
  • За замовчуванням: 0.0
• afArg4: число, яке треба підставити в якості четвертого аргументу в тексті.
  • За замовчуванням: 0.0
• afArg5: число, яке треба підставити в якості п'ятого аргументу в тексті.
  • За замовчуванням: 0.0
• afArg6: число, яке треба підставити в якості шостого аргументу в тексті.
  • За замовчуванням: 0.0
• afArg7: число, яке треба підставити в якості сьомого аргументу в тексті.
  • За замовчуванням: 0.0
• afArg8: число, яке треба підставити в якості восьмого аргументу в тексті.
  • За замовчуванням: 0.0
• afArg9: число, яке треба підставити в якості дев'ятого аргументу в тексті.
  • За замовчуванням: 0.0

Повернення значень

For a message with the message box option and buttons defined:

• returns 0, 1, 2, ..., 9 matching the button the user hit

For a message with the message box option but no buttons defined:

• returns 0 when the OK button is hit (a default OK button is shown on the message box)

If the message box option is not checked:

• returns -1 immediately (and the message is shown as a notification)

When called on a property or variable that isn't filled correctly:

• returns 0 immediately (and nothing is shown)

Приклади

; Display a simple message to the user
HelloWorld.Show()

; Display a message, replacing the first number with a 10
YouGotGold.Show(10.0)

;/ Display a message, replacing the second number with a 10, the third number with a 20 (leaving first 0), and getting
   the button the user hit /;
int ibutton = YetAnotherMessage.Show(0.0, 10.0, 20.0)

Using the above example, you could show a message box whose text is "You've collected %.0f apples and %.0f oranges. You now have %.0f fruits total." This would result in the displayed text "You've collected 0 apples and 10 oranges. You now have 20 fruits total."

Зауваження

To designate where to put the numbers in the message in the editor, the following format is used:

%[flags][width][.precision]f

If you want the message to contain a % sign, then you must use a double % sign like so:

%%

These arguments do not appear to work on buttons.

Прапорці

Flags is one or more of the following characters:

Character	Meaning	Default
-	Left-align the number	Right-align the number
+	Prefix the number with a + or - sign	Prefix only negative numbers with a - sign
0	If width is prefixed with a 0, 0s are added until the minimum width is reached. If both 0 and – flags appear, the 0 is ignored.	No padding is used
<Space>	Prefix the value with a space if the output value is signed and positive. This flag is ignored if both the space and + flags appear.	No space appears
#	Forces the number to have a decimal point.	Decimal point appears only if numbers follow it.

Ширина

This is an optional number that specifies the minimum number of characters to output. This includes the sign character (+ or -) and the decimal point, if any.

Точність

This value specifies the number of digits after the decimal point. If a decimal point appears, there is always at least one digit before it. The value is rounded to the appropriate number of digits.

The default precision is 6. If precision is 0, or if the period appears without a number following it, no decimal point is printed.

Приклади

Значення:

5
1.1
-0.523456745

"%f" дасть результат:

5.0
1.1
-0.523457

"%.0f" дасть результат:

5
1
-1

"%+05f" дасть результат:

+0005
+01.1
-0.523457

"%10.2f" дасть результат:

      5.00
      1.10
     -0.52

Див. також

• Message Script (en)
• Options Menu (en)

Україномовний матеріал Потребує перекладу всього тексту або окремих його частин.

Language:	English  • українська