Команды управления объектами

С помощью команд управления объектами вы можете руководить отображением и положением объектов в вашем проекте. К командам управления объектами также относятся две функции для загрузки/изменения текста.




Hide("ИмяОбъекта")
Пояснение
Скрывает объект, имя которого указано в качестве параметра.

С помощью этой команды можно скрыть как отдельные объекты, так и группы объектов. Имя объекта или группы объектов, которые должны быть скрыты, указывается в кавычках внутри скобок.
Примеры
** Скрывает объект с именем "Button"
Hide("Button")

** Скрывает группу объектов с именем "Group"
Hide("Group")
Дополнительная информация
Визуальные подключаемые модули не могут быть скрыты с помощью этой команды. Чтобы скрыть их, используйте специальные команды (описанные разработчиком модуля).



Show("ИмяОбъекта")
Пояснение
Отображает объект, имя которого указано в качестве параметра.

С помощью этой команды можно сделать видимыми как отдельные объекты, так и группы объектов. Имя объекта или группы объектов, которые должны быть отображены, указывается в кавычках внутри скобок.
Примеры
** Отображает объект с именем "Button"
Show("Button")

** Отображает группу объектов с именем "Group"
Show("Group")
Дополнительная информация
Если визуальные подключаемые модули в данный момент невидимы, то они не могут быть отображены с помощью этой команды. Чтобы отобразить их, используйте специальные команды (описанные разработчиком модуля).



Invert("ИмяОбъекта")
Пояснение
Изменяет видимость объекта, имя которого указано в качестве параметра, на противоположную. Если объект был невидим, то он будет отображен. Если объект был видим, то он будет скрыт.

С помощью этой команды можно инвертировать видимость как отдельных объектов, так и групп объектов. Имя объекта или группы объектов, видимость которых должны быть инвертирована, указывается в кавычках внутри скобок.
Примеры
** Инвертирует объект с именем "Button"
Invert("Button")

** Инвертирует видимость группы объектов с именем "Group"
Invert("Group")
Дополнительная информация
Видимость визуальных подключаемых модулей не может быть изменена с помощью этой команды. Поэтому используйте специальные команды (описанные разработчиком модуля) для изменения видимости этих объектов.



MoveObject("ИмяОбъекта","x,y[,w,h]")
Пояснение
Перемещает и изменяет размеры объекта, имя которого указано в качестве первого параметра, в соответствии с координатами и размерами, которые заданы во втором параметре команды.

MoveObject("ИмяОбъекта","x,y,w,h")

Второй параметр содержит 4 значения:

x - координата объекта в пикселях по оси X (обязательное значение)
y - координата объекта в пикселях по оси Y (обязательное значение)
w - длина объекта в пикселях (необязательное значение)
h - высота объекта в пикселях (необязательное значение)


С помощью этой команды можно перемещать как отдельные объекты, так и группы объектов. Имя объекта или группы объектов, которые должны быть перемещены, указывается в качестве первого параметра в кавычках внутри скобок. Изменение размера применимо только к отдельным объектам.

Второй параметр может содержать либо только координаты объекта:

MoveObject("Bitmap","145,188")

...либо одновременно и координаты, и размеры:

MoveObject("Bitmap","145,188,50,50")
Примеры
** Перемещение объекта "Bitmap" без изменения его размеров
MoveObject("Bitmap","201,325")

** Перемещение объекта "Bitmap" с изменением его размеров
MoveObject("Bitmap","201,325,38,11")

** Перемещение группы объектов "GroupOfBitmaps"
MoveObject("GroupOfBitmaps","150,50")

** Перемещение объекта "Bitmap" с использованием числовых переменных
MoveObject("Bitmap","xpos,ypos,width,height")
Дополнительная информация
Совместное использование команды MoveObject с функциями MouseX() и MouseY() и циклом for..next может дать интересные результаты: объекты можно будет перемещать в реальном времени при перемещении указателя мыши.



MoveTo("ИмяОбъекта","Параметры")
Пояснение
Перемещает объект, имя которого указано в качестве первого параметра, в соответствии с координатами и параметрами анимации перемещения, которые заданы во втором параметре команды.

MoveTo("ИмяОбъекта","x,y,Число Шагов,Тип Анимации")

Второй параметр содержит 4 значения:

x - координата объекта в пикселях по оси X (обязательное значение)
y - координата объекта в пикселях по оси Y (обязательное значение)

Число Шагов - число шагов, используемых для анимации объекта - меньшее значение делает перемещение более быстрым, большее значение делает перемещение плавным и медленным

Тип Анимации - задает тип перемещения объекта. Возможны два значения:
  • EASYTO (объект начинает движение на высокой скорости, постепенно замедляясь по мере приближения к конечной точке)
  • EASYFROM (объект начинает движение с малой скорости, постепенно увеличивая ее по мере приближения к конечной точке)



С помощью этой команды можно перемещать как отдельные объекты, так и группы объектов. Имя объекта или группы объектов, которые должны быть перемещены, указывается в качестве первого параметра в кавычках внутри скобок.
Примеры
** Перемещение объекта "Bitmap" за 40 шагов с ускорением движения
MoveTo("Bitmap","201,325,40,EASYFROM")

** Перемещение объекта "Bitmap" за 10 шагов с замедлением движения
MoveTo("Bitmap","201,325,10,EASYTO")

** Перемещение объекта "Bitmap" с использованием числовых переменных и с замедлением движения
MoveTo("Bitmap","xpos,ypos,steps,EASYTO")

** Перемещение группы объектов "BitmapGroup" за 20 шагов с ускорением движения
MoveTo("BitmapGroup","201,325,20,EASYFROM")
Дополнительная информация
Совместное использование команды MoveTo с функциями MouseX() и MouseY() и циклом for..next может дать интересные результаты: объекты можно будет перемещать в реальном времени при перемещении указателя мыши.



ReorderObject("ИмяОбъекта","Параметры")
Пояснение
Изменяет текущее положение заданного объекта по оси Z. Допустимыми параметрами являются:

FRONT - перемещение объекта на передний план
BACK - перемещение объекта на задний план
FORWARD - перемещение объекта на одну позицию выше
BACKWARD - перемещение объекта на одну позицию ниже


Примеры
** Помещает объект поверх других объектов
ReorderObject("ИмяОбъекта","FRONT")

** Перемещение объекта на одну позицию ниже
ReorderObject("ИмяОбъекта","BACKWARD")



DisplayValue("ИмяОбъекта","Значение")
Пояснение
Загружает значение числовой или строковой переменной в текстовый объект или заголовок кнопки. Первый параметр задает имя объекта, в который будет загружено значение. Второй параметр задает исходную переменную, из которой будет загружено значение.

Примеры
** Отображение значения строковой переменной в текстовом объекте NameLabel
name$='Chuck'
DisplayValue("NameLabel","name$")

** Отображение значения числовой переменной в текстовом объекте AgeLabel
age=23
DisplayValue("AgeLabel","age")

** Отображение значения строковой переменной в заголовке кнопки
Item$='Файл'
DisplayValue("TextBTN","Item$")
Дополнительная информация
Эта команда должна использоваться только для коротких строк. Чтобы загружать абзацы, используйте команду LoadText.



LoadText("ИмяОбъекта","Текст")
Пояснение
Загружает значение строковой переменной, содержимое внешнего файла или просто текст в текстовый объект, заголовок кнопки, эдитбокс (EditBox) или в многострочный текстовый объект с полосой прокрутки (Paragraph).

LoadText("ИмяОбъекта","ИсточникТекста")



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

- строковая переменная
- текстовый файл (<SrcDir>\Text.txt)
- элемент внутреннего списка (<List>5)
- обычный текст в качестве параметра
Примеры
** Загрузка текста в объект Paragraph из строковой переменной text$
LoadText("Paragraph","text$")

** Загрузка текста в объект Paragraph из внешнего файла
LoadText("Paragraph","<SrcDir>\Text.txt")

** Загрузка в объект Paragraph элемента 7 из внутреннего списка MMB
LoadText("Paragraph","<List>7")

** Загрузка в объект Paragraph текста, указанного в качестве второго параметра
LoadText("Paragraph","Привет, MMB!")

** Загрузка текста в объект EditBox из строковой переменной input$
LoadText("EditBox","input$")
Дополнительная информация
MMB распознает путь к файлу, указанный в качестве второго параметра, как ссылку на файл, содержимое которого необходимо загрузить в текстовый объект. Но иногда у вас может появиться необходимость просто отобразить в текстовом объекте путь к файлу, не загружая в него содержимое самого файла. Чтобы управлять поведением команды в подобных случаях, используйте следующие параметры:

STRING - указывает команде, что путь необходимо обрабатывать как обычный текст:

LoadText("Paragraph","STRING:File$")

FILE - указывает команде, что путь необходимо обрабатывать как ссылку на внешний файл:

LoadText("Paragraph","FILE:File$")

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

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