Управление глобальными параметрами

Общая информация


SetObjectParam("ИмяОбъекта","Параметры") - эта команда позволяет вам задавать/изменять некоторые из основных свойств объектов MMB во время выполнения приложения.

SetProjectParam
("ПараметрПроекта","Параметры") - эта команда позволяет вам задавать/изменять некоторые свойства проекта во время выполнения приложения.

Увидеть обе команды с их параметрами в действии вы можете в проекте 497_test_project.mbd.

SetObjectParam("ИмяОбъекта","Параметры")
Пояснение
Обычно вы задаете параметры объекта в окне его свойств во время разработки проекта. Но с помощью этой волшебной команды вы можете задавать некоторые параметры объектов непосредственно во время выполнения приложения.

Вот список возможных параметров с указанием объектов, к которым применим тот или иной параметр:

Параметр Значение Описание|Использование Объекты
MOUSEDOWNSCRIPT=
MOUSEUPSCRIPT=

MOUSEDOWNSCRIPT:0 или 1:=
MOUSEUPSCRIPT:0 или 1:=
код скрипта или строковая переменная Задает скрипт по событию Mouse Up/Down для объекта.

Дополнительный параметр :0 или :1 предназначен для обработки синтаксиса без предупреждений/с предупреждениями. В случае каких-либо ошибок в скрипте (т.е. использования неверного синтаксиса) и активном параметре :1 вы будете оповещены о неправильном синтаксисе с помощью сообщения об ошибке. Будьте осторожны при использовании обработки синтаксиса без предупреждений! В этом случае вы можете пропустить некоторые синтаксические ошибки!
Круг
Активная область
Прямоугольник
Текстовый объект
Кнопка
Растровый объект
Кнопка на основе изображения
SCRIPT=

SCRIPT:0 или 1:=
SCRIPT:0 или 1:=
код скрипта или строковая переменная Задает код для объекта-скрипта.

Также как и для вышеприведенного параметра MOUSEDOWNSCRIPT/MOUSEUPSCRIPT дополнительный параметр :0 или :1 предназначен для обработки синтаксиса без предупреждений/с предупреждениями.
Скрипт
BGCOLOR= R,G,B Задает цвет фона объекта. Вместо букв R, G и B указываются целочисленные значения в диапазоне 0..255. Также в качестве параметра может использоваться строковая переменная, содержащая значения RGB, разделенные запятыми; или значение константы CBK_SelColor, полученное в результате использования команды ColorPicker(). Эдитбокс
Примитивы
Кнопка
Список
BG= TRUE/FALSE Включает/выключает фон эдитбокса.

SetObjectParam("Object","BG=TRUE")
Эдитбокс
BGCOLOR= R,G,B Задает цвет фона объекта. Вместо букв R, G и B указываются целочисленные значения в диапазоне 0..255. Также в качестве параметра может использоваться строковая переменная, содержащая значения RGB, разделенные запятыми; или значение константы CBK_SelColor, полученное в результате использования команды ColorPicker(). Эдитбокс
Примитивы
Кнопка
Список
BORDERCOLOR= R,G,B Задает цвет границы объекта. Параметры R,G,B задаются так же, как для параметра BGCOLOR, описанного выше.

ПРИМЕЧАНИЕ: Цвет границы может быть изменен только для стиля границы "Линия" (Line).
Эдитбокс
Примитивы
BORDERTYPE= LINE
WINDOWS
SUNKEN
NONE
Задает стиль границы объекта. Поддерживаемые параметры такие же, как задаваемые в окне свойств объектов во время разработки проекта.

LINE - линия толщиной в один пиксель
WINDOWS - выпуклая граница объекта
SUNKEN - вдавленная граница объекта
NONE - без границы
Эдитбокс
Примитивы
TEXTCOLOR= R,G,B Задает цвет текста в поддерживаемых объектах. Параметры R,G,B задаются так же, как для параметров BGCOLOR и BORDERCOLOR. Эдитбокс
Текстовый объект
Текст с полосой
прокрутки
Кнопка
Список
FONTNAME= Название шрифта Задает шрифт в поддерживаемых объектах. Название шрифта представляет собой не имя файла, как вы могли подумать! Название - это имя, под которым шрифт зарегистрирован в Windows. Имя шрифта вы можете увидеть в его свойствах или в диалоговом окне выбора шрифта. Эдитбокс
Текстовый объект
Текст с полосой
прокрутки
Кнопка
Список
FONTSTYLE= REGULAR
ITALIC
BOLD
BOLDITALIC
Задает стиль начертания шрифта. Эдитбокс
Текстовый объект
Текст с полосой
прокрутки
Кнопка
Список
FONTSIZE= Число Задает размер шрифта. Эдитбокс
Текстовый объект
Текст с полосой
прокрутки
Кнопка
Список
FONTEFFECT= NONE
STRIKEOUT
UNDERLINE
STRIKEUNDER
Задает видоизменение шрифта.

NONE - без видоизменения
STRIKEOUT - зачеркнутый
UNDERLINE - с подчеркиванием
STRIKEUNDER - зачеркнутый с подчеркиванием
Эдитбокс
Текстовый объект
Текст с полосой
прокрутки
Кнопка
Список
FONTSCRIPT= Число Задает используемый набор символов.

Номер набора может быть выбран из нижеприведенной таблицы:

Номер
Набор символов
0 Западный
1 Другой
2 Символьный
77 MAC
128 Японский
129 Корейский (Wansung)
130 Корейский (Johab)
134 Упрощенный китайский
136 Традиционный китайский
161 Греческий
162 Турецкий
163 Вьетнамский
177 Иврит
178 Арабский
186 Балтийский
204 Кириллический
222 Тайский
238 Центральноевропейский

Эдитбокс
Текстовый объект
Текст с полосой
прокрутки
Кнопка
Список
FONTALL= CBK_Font или строка с разделителем Этот параметр просто позволяет задать все свойства шрифта с помощью одной строчки кода. Значение параметра может быть указано с помощью константы CBK_Font, полученной в результате использования команды FontPicker(), или с помощью строки следующего вида:

ШРИФТ|НАЧЕРТАНИЕ|РАЗМЕР|НАБОРСИМВОЛОВ|
ВИДОИЗМЕНЕНИЕ|
Эдитбокс
Текстовый объект
Текст с полосой
прокрутки
Кнопка
Список
Примеры
** Установка (или замена текущего скрипта) команды Message в качестве скрипта для объекта TextBTN (обработка с предупреждениями)
SetObjectParam("TextBTN","MOUSEUPSCRIPT:1=Message("Привет!","")")

** Установка (или замена текущего скрипта) команды Message в качестве скрипта для объекта с использованием строковой переменной (и обработкой без предупреждений)
code$='Message("","a")'
SetObjectParam("Script","MOUSEUPSCRIPT:0=code$")

** Установка красного цвета в качестве фонового цвета объекта
SetObjectParam("Object","BGCOLOR=255,0,0")

** Установка фонового цвета объекта с помощью диалогового окна выбора цвета
ColorPicker()
SetObjectParam("Object","BGCOLOR=CBK_SelColor")

** Пример использования команды SetObjectParam с параметром FONTALL
SetObjectParam("Object","FONTALL=arial|regular|12|204|none|")
** или так...
parameter$='arial|regular|12|204|none|'
SetObjectParam("Object","FONTALL=parameter$")
** или так...
SetObjectParam("Object","FONTALL=CBK_Font")



SetProjectParam("ПараметрПроекта","Параметры")
Пояснение
Эта команда задает некоторые свойства проекта (в настоящее время это в основном свойства страниц) во время выполнения приложения.

Ниже приведена таблица возможных параметров:


1-ый параметр 2-ой параметр Значение Описание|Использование
PAGEBG= IMAGE= path$ Задает фоновое изображение страницы. Если параметр IMAGE= содержит пустую строку, то текущее фоновое изображение будет удалено.
PAGEBG= DISPLAY= TILE
NORMAL
Задает стиль замощения фонового изображения. В настоящий момент доступны только значения TILE и NORMAL... к сожалению, значение STRETCH пока не предусмотрено :)

TILE - замостить изображение
NORMAL - без замощения
PAGEBG= COLOR= R,G,B Задает цвет фона страницы. Синтаксис такой же, как в команде SetObjectParam.
PAGEBG= FROMMASTER= TRUE/FALSE Позволяет использовать/не использовать в качестве фона страницы фон нижнего мастер-слоя (Master Page).
MASTERPAGEBG= IMAGE= path$ Задает фоновое изображение нижнего мастер-слоя. Если параметр IMAGE= содержит пустую строку, то текущее фоновое изображение будет удалено.
MASTERPAGEBG= DISPLAY= TILE
NORMAL
Задает стиль замощения фонового изображения нижнего мастер-слоя. В настоящий момент доступны только значения TILE и NORMAL... к сожалению, значение STRETCH пока не предусмотрено :)
MASTERPAGEBG= COLOR= R,G,B Задает цвет фона нижнего мастер-слоя. Синтаксис такой же, как в команде SetObjectParam.
FULLSCREENBG= IMAGE= path$ Задает фоновое изображение полноэкранного приложения. Если параметр IMAGE= содержит пустую строку, то текущее фоновое изображение будет удалено.
FULLSCREENBG= DISPLAY= TILE
STRETCH
NORMAL
Задает стиль замощения фонового изображения полноэкранного приложения.

TILE - замостить изображение
STRETCH - растянуть изображение
NORMAL - без замощения
FULLSCREENBG= COLOR= R,G,B Задает цвет фона полноэкранного приложения. Синтаксис такой же, как в команде SetObjectParam.
Примеры
** Загрузка фонового изображения страницы
SetProjectParam("PAGEBG","IMAGE=<SrcDir>\Images\image.jpg")

** Растяжение фонового изображения полноэкранного приложения
SetProjectParam("FULLSCREENBG","DISPLAY=STRETCH")

** Установка фонового цвета нижнего мастер-слоя
SetProjectParam("MASTERPAGEBG","COLOR=CBK_SelColor")

MMB Программирование без границ :: dgilmour, перевод на русский язык, 2006 :: Все права защищены :: www.mmbscript.ru