Описание функции


SplashTextOn

Создаёт настроенное всплывающее окно с текстом.

SplashTextOn('title','text'[,w=500[,h=400[,x pos[,y pos[,opt=0[,'fontname'[,fontsz=12[,fontwt]]]]]]]])

Параметры

title Заголовок окна всплывающего окна.
text Текст всплывающего окна.
w [необязательный] Ширина окна в пикселях. (по умолчанию равна 500)
h [необязательный] Высота окна в пикселях. (по умолчанию равна 400)
x pos [необязательный] Отступ слева (в пикселях) для окна с изображением (по умолчанию окно центрируется).
y pos [необязательный] Отступ сверху (в пикселях) для окна с изображением (по умолчанию окно центрируется).
opt [необязательный] По умолчанию 'поверх всех окон, с заголовком, выравнивание по центру'
Сложите необходимые значения:
0 = выравнивание по центру, поверх всех окон, с заголовком (по умолчанию)
1 = окно без заголовка и границ
2 = отключает "поверх всех окон"
4 = выравнивание текста по левому краю
8 = выравнивание текста по правому краю
16 = окно может быть перемещено
32 = центрировать текст по вертикали
fontname [необязательный] Шрифт для использования (если значение "" или шрифт не найден, будет использован шрифт OS по умолчанию для GUI)
fontsz [необязательный] Размер шрифта (по умолчанию 12; стандартные размеры: 6 8 9 10 11 12 14 16 18 20 22 24 26 28 36 48 72)
fontwt [необязательный] Толщина шрифта (0 - 1000, по умолчанию 400 = нормальный). Значение > 1000 интерпретируется, как 0.

Возвращаемое значение

Возвращает дескриптор всплывающего окна, который может быть использован в функции ControlSetText.

Примечания

Чтобы пропустить указание необязательного параметра, оставьте вместо него значение по умолчанию, равное:
'' для строковых параметров
-1 для числовых параметров

Только одно окно SplashImage/Text может быть отображено одновременно.

Еще лучше использовать ControlSetText для обновления текста без мерцания...
Если текст по центру и многострочный, то ControlSetText не превысит количество строк созданное SplashTextOn.

Всплывающее окно с параметром opt равным 1 не может быть перемещено и не может быть активировано.

Имена стандартных шрифтов:
Arial, Comic Sans MS, Courier New, Lucida Console, Microsoft Sans Serif, System, Tahoma, Times New Roman, и WingDings
См. Приложения для получения полного списка шрифтов

Используйте @LF для отображения нескольких строк текста.

Функцию можно подключить через команду exect
Для передачи пустой строки можно воспользоваться ключевым словом Null
Для передачи значения по умолчанию можно воспользоваться ключевым словом Default

См. также

SplashOff, ToolTip, MsgBox

Примеры:
 Как создать кнопку?

; i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i! Комментарий i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!
SplashTextOn('Заголовок','Сообщения~~появляются~~здесь.', -1,-1,-1,-1,4,)
Sleep(3000)
SplashOff()
; i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!i!

exect=SplashTextOn('Заголовок','Моё~~Сообщение...',200,50)&Sleep(3000)&SplashOff() ;; пример окна с текстом

exect=$var_ii=##[input=BOX68]||$var_im=$var_ii&'n' pause=$var_im sndps=1 exect=SplashTextOn('Напоминаю','Прошло~~$var_ii~~минут(ы)',200,50)&Sleep(10000)&SplashOff() ;; через заданное количество минут выдать сообщение (количество вводится в диалоге)

exect=SplashTextOn('Заголовок','Дата:~~'&StringFormat('%%04d.%%02d.%%02d~~%%02d:%%02d:%%02d',@YEAR,@MON,@MDAY,@HOUR,@MIN,@SEC),300,200,-1,5,0,Null,38,700)+Sleep(3000)+SplashOff() ;; пример окна с датой

exect=SplashTextOn('Заголовок',StringReplace(ClipGet(),'&','&&'),200,50)&Sleep(3000)&SplashOff() ;; пример окна с текстом из буфера обмена (удвоение для корректного отображения символа "&")


© Аверин Андрей для Total Commander Image  Averin-And@yandex.ru