LOCAL – лосальные переменные и массивы переменных

Министерство общего и профессионального образования
Российской Федерации
Хабаровский государственный технический университет
ИНФОРМАЦИОННОЕ ОБЕСПЕЧЕНИЕ
СИСТЕМ УПРАВЛЕНИЯ
Методические указания к практическим занятиям
для студентов специальности 210100
"Автоматика и информатика в технических системах"
Хабаровск
Издательство ХГТУ
2002
2
СОДЕРЖАНИЕ
1. Объектно-ориентированное программирование
1.1. Общие сведения о VisualFoxPro
1.2. Типы переменных
2. Классы VisualFoxPro
2.1. Класс CheckBox
2.2. Класс ComboBox
2.3. Класс CommandButton
2.4. Класс CommandGroup
2.5. Класс Container
2.6. Класс Control
2.7. Класс Cursor
2.8. Класс Custom
2.9. Класс DataEnvironment
2.10. Класс EditBox
2.11. Класс Form
2.12. Класс FormSet
2.13. Класс Grid
2.14. Класс Column
2.15. Класс Header
2.16. Класс Image
2.17. Класс Label
2.18. Класс Line
2.19. Класс ListBox
2.20. Класс OLEControl
2.21. Класс OLEBoundControl
2.22. Класс OptionButton
2.23. Класс OptionGroup
2.24. Класс Page
2.25. Класс PageFrame
2.26. Класс Relation
2.27. Класс Separator
2.28. Класс Shape
2.29. Класс Spinner
2.30. Класс TextBox
2.31. Класс Timer
2.32. Класс ToolBar
2.33. Класс ActiveDocument
2.34. Класс Hyperlink
2.35. Класс ProjectHook
Список использованных источников
3
3
3
4
4
23
33
34
36
37
38
40
40
41
43
51
52
57
59
60
61
61
62
63
64
65
65
66
67
68
69
69
50
70
71
72
73
74
76
78
3
1. ОБЪЕКТНО-ОРИЕНТИРОВАННОЕ ПРОГРАММИРОВАНИЕ
1.1. Общие сведения о VisualFoxPro
VisualFoxPro - это полнофункциональный язык объектно-ориентированного
программирования. Он предлагает мощные средства для интерактивной работы и
создания приложений, предназначенных для управления реляционными базами
данных.
Основу объектно-ориентированного программирования составляют классы.
Класс - это некая структура, в которой сгруппированны элементы, соответствующие
данным о некотором объекте, и оперирующие этими данными функции. Класс
содержит определенные свойства, методы и обрабатываемые им события. Объект
является экземпляром класса, который наследует характеристики класса.
Для VisualFoxPro версии 6.0 существует 35 видов базовых классов. На основе
их пользователь может создавать свои собственные классы с нужными ему
свойствами и методами, причем свойства и методы также могут быть совершенно
отличными от уже существующих.
Различают визуальные классы, т.е. которые изображаются на экране при
выполнении приложения, и невизуальные, а так же классы контейнеры, т.е. классы в
состав которых могут входить другие классы, и неконтейнеры.
Свойства классов влияют на их различные характеристики и их значение не
всегда может менятся как в процессе програмирования, так и во время выполнения
приложения.
События это реакция объекта, т.е. класса, на некоторое действие пользователя
или какое-либо другой внутрений процесс. Иногда, при желании программиста и
соответствующем програмировании, события могут вызываться искусственно, даже
когда необходимое для их появления действие не произошло.
Метод это определенное действие, т.е. функция, с помощью которой
програмист может выполнить над классом и его содержимым некоторые действия.
Несмотря на отличия разных классов друг от друга у них могут существовать
одинаковые свойства, методы и события, иногда с незначительными отличиями.
Также необходимо отметить такую характеристику объекта как фокус, который, при
его наличии для объекта, свидетельствует что данный объект является текущим
активным объектом, т.е. с ним работает пользователь и все события вызываются
именно для данного объекта. Далее мы рассмотрим некоторые особенности при
работе с методами и событиями классов.
1.2. Типы переменных
В VisualFoxPro, как и в других языках програмирования, существует несколько
типов переменных, например числовые, символьные, логические, даты и т.д., причем
их тип может задаваться первыми буквами каждой переменной, например
переменная cName - содержит набор символов, nColor - некоторое число и т.д. Также
они различаются и по области их применения в программе. Существуют локальные
(LOCAL – лосальные переменные и массивы переменных значения которых
используются и могут изменяться в пределах процедуры или функции где они были
4
непосредственно объявленны. Доступ к ним из других
частей программы
невозможен, а после завершения содержащей их процедуры или функции эти
переменные и массивы уничтожаются.) и глобальные (GLOBAL/PUBLIC переменные и массивы переменных, значения доступны из любой части программы,
функций и т.д.)
При использовании событий определенных классов широко используется
команда LPARAMETERS. Она – создает локальные переменные или массивы,
связанные с вызванной программой, процедурой или пользовательской функцией.
Для того чтобы данные программы и функции могли передавать значения величин,
переменных или массивов в другие программы, процедуры или пользовательские
функции LPARAMETERS должно находиться в самой первой исполняемой строке
соответствующих функций и программ.
Далее будут непосредственно рассматриваться все классы VisualFoxPro.
2. КЛАССЫ VisualFoxPro
2.1. Класс CheckBox
2.1.1. Использование класса CheckBox
Данный класс является визуальным и неконтейнером. В приложениях
пользователя он может использоваться для различных целей, например для
отображения и изменения какого-либо параметра, значение которого имеет два
варианта (истинна или ложь, нуль или единица, да или нет и т.п.) и представляет
собой по своей сути флажок.
2.1.2.Свойства класса CheckBox
Alignment – определяет выравнивание текста, ассоциированого с объектом.
Данное свойство доступно как во время разработки так и выполнения.
Синтаксис: Control.Alignment[ = nAlign]
nAlign - для CheckBox имеет следующие допустимые значения:
0
(по умолчанию) Выравнивание по левому краю.
1
Выравнивание по правому краю.
nAlign
- для
ComboBox, EditBox, Header, Label и Spinner существуют
следующие значения:
0
(по умолчанию) Выравнивание по левому краю. По умолчанию для
combo box, edit box, header и label.
1
Выравнивание по правому краю. По умолчанию для spinner.
2
Выравнивание текста по центру с равными пробелами слева и справа.
3
Автоматическое. Выравнивание базируется на типе данных исходного
объекта.
Для ComboBox выравнивание применяется, если значение свойства Style
установлено в 0.
nAlign - для TextBox имеет следующие допустимые значения:
0
Выравнивание по левому краю.
1
Выравнивание по правому краю.
2
Выравнивание текста по центру с равными пробелами слева и справа.
5
3
(по умолчанию) Автоматическое. Для TextBox не состоящих в Column
выравнивание базируется на типе данных исходного объекта. Численные типы
данных (numeric, double, float, currency, integer) выравниваются по правому краю, а
остальные типы по левому. Для TextBox состоящих в Column, выравнивание
устанавливается в зависимости от текста в Text Box.
nAlign - для класса Сolumn имеет следующие допустимые значения: :
0
Выравнивание текста по левому краю и центрирование по вертикали.
1
Выравнивание текста по правому краю и центрирование по вертикали.
2
Выравнивание текста по центру с равными пробелами слева и справа и
центрирование по вертикали.
3
(по умолчанию) Автоматическое. Выравнивание базируется на типе
данных исходного объекта. Численные типы данных (numeric, double, float, currency,
integer) выравниваются по правому краю, а остальные типы по левому.
4
Выравнивание по левому краю сверху.
5
Выравнивание по правому краю сверху.
6
Выравнивание текста по центру с равными пробелами слева и справа, а
также сверху.
7
Выравнивание по левому краю снизу.
8
Выравнивание по правому краю снизу.
9
Выравнивание текста по центру с равными пробелами слева и справа, а
также снизу.
Application - обеспечивает доступ к объекту Application, содержащему данный
объект. Не доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Object.Application.Property [ = Setting]
или Object.Application.Method
Property - указывает свойство.
Setting - задает новое значение данного свойства.
Method - указывает метод объекта.
AutoSize – указывает когда объект автоматически изменяет свои размеры для
соответствия его собственному содержанию. Данное свойство доступно как во
время разработки так и выполнения.
Синтаксис: Control.AutoSize[ = lExpr]
lExpr – существуют следующие значения
True (.T.) Объект изменяется.
False (.F.) (по умолчанию) Содержимое объекта урезается, когда
оно превышает его размеры. Размеры объекта постоянны.
BackColor – определяет фоновый цвет, используемый для отображения текста и
графики в объекте. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Object.BackColor[ = nColor]
nColor – указывает значение цвета. Например
Цвет
В формате RGB
Величина
белый
255, 255, 255
16777215
черный
0, 0, 0
0
серый
192, 192, 192
12632256
6
BackStyle – указывает когда фон объекта прозрачен или нет. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис: Object.BackStyle[ = nStyle]
nStyle - существуют следующие значения
0
прозрачный. Все, что за обьектом видимо. Свойство BackColor
игнорируется.
1
(по умолчанию)непрозрачный.
BaseClass – указывает имя базового класса Visual FoxPro, на основе которого
создан данный класс. Всегда только для чтения.
Синтаксис: Object.BaseClass[ = cBaseClass]
сBaseClass - указывает имя базового класса Visual FoxPro, на основе которого создан
данный класс.
Caption – определяет текст, отображаемый в заголовке объекта. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис: Object.Caption[ = cText]
cText - определяет текст, отображаемый в объекте.
Данное свойство для различных объектов имеет свои особенности:
· Для Form это свойство указывает текст, отображенный в заголовке формы.
Когда форма минимизированна, этот текст изображен за иконкой формы.
· Для Page объекта PageFrame свойство Caption определяет текст, изображенный
в загголовке каждой страницы.
· Для объектов оно указывает текст, показанный на объекте.
· Для объектов, у которых свойство Style установлено в 1 (Graphical) и для
минимизированных форм, заголовок изображен над иконкой.
· При создании новых объектов их свойство Caption по умолчанию состоит из
значения свойства Name и числа.
· Для CommandGroup и OptionGroup текст caption показан, если свойство
BorderStyle установлено в 1 (Fixed Single).
· Для Label , максимальное число символов в Caption 256.
· Для того чтобы привязать нажатие определенной клавищи с объектом нужно
включить символы «\<» в свойстве caption сразу за этой клавишей. Теперь
пользователь при нажатии этой клавиши и ALT переходит к заданному объекту.
Если объект это command button, check box или option button, то нажатие этой
комбинации клавиш аналогично щелчку мыши на этом объекте.
Class - возвращает имя класса на основе которого создан объект. Доступно
только для чтения.
Синтаксис:
Object.Class
ClassLibrary – указывает имя файла библиотеки определенного пользователем
класса. Доступно только для чтения.
Синтаксис: Object.ClassLibrary
Базовые классы Visual FoxPro встроенные и не имеют этой установки.
ColorScheme – включено для совместимости с предидущими версиями.
Необходимо использовать свойства BackColor и ForeColor.
ColorSource – определяет как установлены цвета объекта. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис: Object.ColorSource[ = nSource]
7
nSource – имеет следующие значения:
0 - Object’s Color Properties
- собственные цвета объекта (используются
значения ForeColor, BackColor и т.д.).
1 - Form’s Color Scheme - объект использует цвета формы, на которой он
находится.
2 - ColorScheme Property Scheme
- объект использует схему цветов,
определенную в свойстве ColorScheme.
3 - Default Scheme
- объект использует цветовую схему по умолчанию. В
основном это схема 1 - form’s color scheme; для EditBox и ListBox цветовая схема по
умолчанию это Scheme 2 - User Menus.
4 - Windows Control Panel (3D Colors) (по умолчанию)
-объект использует
3D цвета, установленные в Windows Control Panel.
5 - Windows Control Panel (Windows Colors)
- объект использует цветовые
схемы, установленные в Windows Control Panel.
Comment – хранит информацию об объекте. В отличие от других свойств, оно
не используется Visual FoxPro и хранит описание объекта или другую информацию
нужную пользователю. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Object.Comment[ = cTextString]
cTextString - содержит текстовую строку
ControlSource – определяет источник данных, связанных с объектом. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.ControlSource[ = cName]
cName – переменная или поле.
Для TextBox cName обычно поле.
Если для Column объекта Grid свойство Bound установлено в истину (.T.),
свойство ControlSource применяется для column и других объектов хранимых в нем,
в другом случае необходимо непосредственно устанавливать свойство ControlSource
каждого объета.
DisabledBackColor - определяет цвет фона для выключенного объекта. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.DisabledBackColor[ = nColor]
или
Control.DisabledBackColor = RGB(nRedValue, nGreenValue, nBlueValue)
nColor – указывает число, определяющее цвет.
nRedValue, nGreenValue, nBlueValue – определяют три различных цветовых
параметра, определяющих конечный цвет.
DisabledForeColor – определяет цвет, используемый для отображения текста и
графики для выключенного объекта. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Control.DisabledForeColor[ = nColor]
или
Control.DisabledForeColor = RGB(nRedValue, nGreenValue, nBlueValue)
nColor, nRedValue, nGreenValue, nBlueValue - данные параметры описаны выше.
DisabledPicture – указывает какую картинку изображать для неактивного
объекта. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.DisabledPicture[ = cPicture]
cPicture – указывает полный путь и имя файла bitmap или имя поля general в таблице.
8
При отсутствии файла сгененерируется ошибка и это свойство будет
игнорироваться.
Для CommandButton для изображения картинки свойство Style должно быть
установлено в 0 (Standard); для CheckBox и OptionButton свойство Style
устанавливается в 1 (Graphical).
DownPicture – определяет картинку, которая изображается, когда объект
выбран. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.DownPicture[ = cPicture]
cPicture - данный параметр описан выше.
При отсутствии файла сгененерируется ошибка и это свойство будет
игнорироваться.
Для CommandButton для изображения картинки свойство Style должно быть
установлено в 0 (Standard); для CheckBox и OptionButton свойство Style
устанавливается в 1 (Graphical).
DragIcon – указывает иконку, изображаемую как курсор при операции
перетаскивания(drag-and-drop). Данное свойство доступно как во время разработки
так и выполнения.
Синтаксис:
Control.DragIcon[ = cIcon]
cIcon – указывает файл, содержащий иконку. Он должен иметь расширение .CUR и
быть сохраненным в формате VGA-Mono 2-Color 32x32. Если файл .CUR цветной
или отсутствует генерируется ошибка. Если cIcon отсутствует используется курсор
типа «рука в прямоугольнике».
Обычно свойство DragIcon используется в течении событий MouseDown или
DragOver.
DragMode – определяет режим для операций перетаскивания (drag-and-drop).
Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.DragMode[ = nMode]
nMode - - имеет следующие допустимые значения:
0 - (Default) Manual
- (по умолчанию)ручное. Требует использования
метода Drag для выполнения перетаскивания исходного объекта.
1 – Automatic
- автоматическое. Щелчок мышью на исходном объекте
автоматически вызывает перетаскивание.
Когда DragMode установленно в 0 (Manual), объект вызывает события мыши и
Drag метод должен использоваться для начала операции.
Когда When DragMode установленно в 1 (Automatic), объект не вызывает
события мыши и операция начанается автоматически когда пользователь нажимает и
держит левую кнопку мыши на объекте.
Когда объект переносится, он не обрабатывает другие события (KeyPress,
MouseDown, MouseMove или MouseUp).
Enabled - указывает когда объект активен, т.е. может реагировать на события.
Данное свойство доступно как во время разработки так и выполнения.
Синтаксис: Object.Enabled[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
- (по умолчанию) объект реагирует на события.
False (.F.)
- объект не реагирует на события.
9
FontBold - указывает применяется для текста объекта данный стиль. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.FontBold[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
данный стиль текста установлен.
False (.F.)
данный стиль текста не установлен.
FontCondense - указывает применяется для текста объекта данный стиль.
Синтаксис:
Object.FontCondense[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
- текст , ассоциированный с объектом изображаются с меньшим
пространством между отдельными буквами, чем обычно.
False (.F.)
- (по умолчанию) текст изображается обычно.
FontExtend - указывает применяется для текста объекта данный стиль.
Синтаксис:
Object.FontExtend[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
- текст , ассоциированный с объектом изображаются с большим
пространством между отдельными буквами, чем обычно.
False (.F.)
- (по умолчанию) текст изображается обычно.
FontItalic - указывает применяется для текста объекта данный стиль. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.FontItalic[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
данный стиль текста установлен.
False (.F.)
(по умолчанию)данный стиль текста не установлен.
FontName - определяет имя шрифта для отображения текста. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
Object.FontName[ = cName]
cName - указывает имя шрифта (по умолчанию Arial ).
По умолчанию размер шрифта устанавливается равным 10 точек.
FontOutline - включено для совместимости с Macintosh.
FontShadow - включено для совместимости с Macintosh.
FontSize - определяет размер шрифта для текста объекта. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
Object.FontSize[ = nSize]
nSize - определяет размер шрифта (по умолчанию 10 точек).
Максимальная величина равна 2048 точек. В одном дюйме 72 точки.
FontStrikeThru - указывает применяется для текста объекта данный стиль.
Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.FontStrikeThru[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
данный стиль текста установлен.
False (.F.)
(по умолчанию)данный стиль текста не установлен.
FontUnderline - указывает применяется для текста объекта данный стиль.
Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.FontUnderline[ = lExpr]
lExpr - имеет следующие допустимые значения:
10
True (.T.)
данный стиль текста установлен.
False (.F.)
(по умолчанию)данный стиль текста не установлен.
ForeColor – определяет цвет, используемый для отображения текста и графики
в объекте. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис: Object.ForeColor[ = nColor]
Height - задает высоту объекта на экране. Данное свойство доступно как во
время разработки так и выполнения.
Синтаксис:
Object.Height[ = nHeight]
nHeight - задает высоту объекта, измеряемую в единицах измерения, определенных в
свойстве ScaleMode формы.
Для формы значение Height не включает рамку и заголовок формы.
HelpContextID - задает номер контексной справки (context ID) в файле помощи
для данного объекта. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Object.HelpContextID[ = nContextID]
nContextID - задает номер контексной справки в графическом или .DBF файле
помощи. Имеет значения от 0 до 268,435,455.
Для создания контексной справки для данного объекта в приложении
польователя необходимо указать заданный в этом свойстве объекта номер и
ассоциировать его с конкретным подразделом справки при создании файла помощи.
Для вызова контексной помощи заданного объекта необходимо чтобы он имел
фокус, иначе появиться основное окно справки.
Left - задает расстояние между левым краем объекта или формы и данным
объектом, находящимся на форме. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Object.Left[ = nDist]
nDist - величина данного расстояния (для формы по умолчанию объектом на
котором она находится является основное окно Visual FoxPro ).
MousePointer - задает контур курсора мыши, когда он находится на объекте во
время выполнеия приложения. Данное свойство доступно как во время разработки
так и выполнения.
Синтаксис:
Object.MousePointer[ = nType]
nType - имеет следующие допустимые значения:
0 (по умолчанию) - контур определяется объектом.
1
- стрелка.
2
- крест.
3
-I-луч.
4
- иконка. Маленький белый квадрат в пределах черного квадрата.
5
- указатель. Четырех направленный указатель, показывающий на север,
юг, восток и запад.
6
- указатель NE SW. Двунаправленный указатель, показывающий на
северовосток и югозапад.
7
- указатель NS. Двунаправленный указатель, показывающий на север и
юг.
8
- указатель NW SE. Двунаправленный указатель, показывающий на
северозапад и юговосток.
11
9
- указатель WE. Двунаправленный указатель, показывающий на запад и
восток.
10
- стрелка вверх.
11
- песочные часы.
12
- не переносится.
13
- скрытый указатель.
14
- стрелка.
Name - указывает имя объекта, используемое в приложении. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис: Object.Name[ = cName]
cName - задает данное имя.
OLEDragMode - указывает как выполняется операция переноса. Данное
свойство относится к источнику переноса и доступно как во время разработки так и
выполнения.
Синтаксис:
Object.OLEDragMode[= nValue]
nValue - имеет следующие допустимые значения:
0 - (Default) Manual
- (по умолчанию)ручное. Требует использования
метода OLEDrag для выполнения перетаскивания исходного объекта.
1 – Automatic
- автоматическое. Щелчок мышью на исходном объекте
автоматически вызывает перетаскивание.
Если свойство DragMode установлено в 1 – Automatic, то объект не может
выступать в роли источника OLE переноса.
Для класса Grid свойство OLEDragMode только для чтения.
OLEDragPicture - задает картинку, изображаемую под курсором мыши в
течении операции OLE переноса. Данное свойство относится к источнику переноса
и доступно как во время разработки так и выполнения.
Синтаксис:
Object.OLEDragPicture[= cFileName]
cFileName - задает имя файла и путь картинки с расширением .bmp, .dib, .jpg, .gif,
.ani, .cur, или .ico.
OLEDropEffects - указывает тип операции OLE переноса для конечного
объекта. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.OLEDropEffects[= nDropEffect]
nDropEffect - имеет следующие допустимые значения:
0
- конечный объект не принимает данные.
1
- данные могут копироваться.
2
- данные могут перемещаться
3
- к данным может организовываться доступ
Возможно использование одновременно нескольких типов, для чего
указывается сумма значений.
OLEDropHasData - указывает как выполняется операция OLE переноса.
Данное свойство доступно во время разработки и только для чтения при
выполнении.
Синтаксис:
Object.OLEDropHasData[= nDropEffect]
nDropEffect - имеет следующие допустимые значения:
-1
- по умолчанию. Visual FoxPro автоматически решает соответствует ли
формат данных формату конечного объекта переноса. Если да то операция переноса
12
выполняется, иначе курсор мыши показывает что операция невозможна и она
отменяется.
0
- курсор мыши показывает что операция невозможна из-за неверного
формата данных и она отменяется.
1
- данные верны и операция выполняется.
Используйте GetFormat в событии OLEDragOver для определения соответствия
формата данных требуемым.
OLEDropMode - указывает как конечный объект OLE переноса управляет этой
операцией. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.OLEDropMode[= nValue]
nValue - имеет следующие допустимые значения:
0
- ( по умолчанию )операция переноса отменена.
1
- операция возможна.
2
- данные минуют данный конечный объект и пересылаются тому
объекту, который содержит данный объект, т.е. его контейнеру. Для этого свойство
OLEDropMode объекта-контейнера должно быть равно 1 или 2 для принятия данных.
Если свойство Enabled объекта установлено в false (.F.) то операция переноса
данных не возможна.
Parent - возвращает родительский объект для данного объекта. Не доступно во
время програмирования; только для чтения при выполнении.
Синтаксис: Control.Parent
ParentClass – возвращает определенный пользователем класс, на основе
которого создан данный класс. Только для чтения при выполнении и во время
програмирования.
Синтаксис:
Object.ParentClass
Picture - указывает файл (.BMP) или иконку (.ICO) изображаемую на объекте.
Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.Picture[ = cFileName ]
cFileName - задает полное имя файла .BMP или .ICO file.
Если файл не существует, то появится сообщение об ошибке и данное свойство
будет игнорироваться.
Для CheckBox и OptionButton свойство Style устанавливается в 1 (Graphical).
Картинка центрируется на объекте.
Для CommandButton свойство Style должно быть равно 0 (Standard). Картинка
центрируется на объекте.
ReadOnly - определяет когда ползовательможет редактировать объект или
когда разрешено обновление таблиц, связанных с объектом Cursor. Не доступно во
время програмирования; только для чтения-записи при выполнении.
Синтаксис:
[Form.]Control.ReadOnly[ = lExpr]
DataEnvironment.Cursor.ReadOnly[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
Редактирование разрешено.
False (.F.)
( по умолчанию) Не разрешено.
Для combo box свойство ReadOnly не может устанавливаться в true (.T.) пока
свойство Style установлено в 2 - Drop-down List.
RightToLeft - необходимо использовать свойство Alignment.
13
SpecialEffect - задает различные опции формата для объекта. Данное свойство
доступно как во время разработки так и выполнения.
Данное
свойство
игнорируется для Command Button.
Синтаксис: [Form.]Control.SpecialEffect = nExpr
nExpr - для CheckBox имеет следующие допустимые значения:
0
- (по умолчанию для всех кроме объекта Container.) 3D. Граница объекта
выглядит трехмерной.
1
- Plain. Граница объекта не выглядит трехмерной.
2
- Flat. Плоский. (Доступно только для Container).
nExpr - для PageFrame, Container ject или Control - имеет следующие допустимые
значения:
0
- увеличенный. Объект изображается выпуклым.
1
- вдавленный. Объект изображается вдавленным в форму.
2
- плоский.
Для
PageFrame свойство SpecialEffect доступно если свойство Tab
установлено в false (.F.). Также, свойство BorderColor PageFrame применяется если
nExpr равен 2 (плоский).
StatusBarText - определяет текст, изображаемый в строке статуса, когда объект
имеет фокус. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
[Form.]Control.StatusBarText[= cText]
cText - указывает данный текст.
Style - задает стиль объекта. Данное свойство доступно как во время разработки
так и выполнения.
Синтаксис:
[Form.]Control.Style[= nType]
nType - для CheckBox и OptionButton имеет следующие допустимые значения:
0
Standard. Стандартный
1
Graphical. Графический. Кнопки могут содержать графику и текст.
nType - для TextBox имеет следующие допустимые значения:
0
(Default) Normal. Нормальный (по умолчанию ).
1
Включен для совместимости с FoxPro версий 2.x для команд @ ... SAY.
TextBox только для чтения и не может получить фокус.
nType - для объекта combo box имеет следующие допустимые значения:
0 - Drop-down combo
- указывает, что объект будет раскрывающимся
списком, из которого пользователь может выбрать значение или ввести его в поле
ввода списка.
2 - Drop-down list
- указывает, что объект будет раскрывающимся
списком и пользователь может только выбирать значения из списка.
nType - для CommandButton имеет следующие допустимые значения:
0
Standard. Стандартный
1
Invisible. Невидимый.
TabIndex - задает порядковый номер для перехода между объектами по
клавише TAB во время выполнения приложения. Данное свойство доступно как во
время разработки так и выполнения.
Синтаксис:
[Object.]Control.TabIndex[ = nOrder]
nOrder - задает данный номер
14
TabStop - указывает может ли пользователь пользоваться клавишей "TAB"
для перемещения фокуса к данному объекту. Данное свойство доступно как во
время разработки так и выполнения.
Синтаксис:
[Object.]Control.TabStop[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
- ( по умолчанию ) Объект или форма включены в порядок
переключений, заданный в свойстве TabIndex.
False (.F.)
- Объект или форма игнорируют порядок переключений, заданный
в свойстве TabIndex, но могут получить фокус при нажатии клавиши мыши на
объекте .
Tag - хранит любые данные для приложения пользователя. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
Object.Tag[ = Expr]
Expr - задает любую строку.
TerminateRead - включено для совместимоси с READ.
ToolTipText - задает текст всплывающей подсказки данного объекта. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.ToolTipText = cText
cText - определяет данный текст (максимум 127 символов).
Top - задает расстояние между верхним краем объекта или формы и данным
объектом, находящимся на форме. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис: Object.Top[ = nValue]
nValue - величина данного расстояния (для формы по умолчанию объектом на
котором она находится является основное окно Visual FoxPro ).
Value - задает текущее значение параметра объекта. Данное свойство доступно
как во время разработки так и выполнения.
Синтаксис:
[Form.]Control.Value[ = nSetting]
nSetting - для CheckBox имеет следующие допустимые значения:
0
( по умолчанию ) Не выбранно.
1
Выбранно.
2
Смешанная величина. Данное значение доступно только программно.
nSetting - для TextBox может быть символьной строкой, числом, датой, временем,
денежной единицей или логическим значением, которое выбранно в данный момент.
По умолчанию это строка.
nSetting - для объекта combo box и Grid имеет следующие допустимые значения:
0
( по умолчанию ) Не выбранно.
1
Выбранно.
2
Смешанная величина. Данное значение доступно только программно.
nSetting - для CommandGroup, ComboBox, EditBox, ListBox, OptionGroup и Spinner
данное значение символьная строка или числовое значение, которое выбранно в
данный момент.
Для объекта Grid свойство Value доступно, если он имеет фокус.
Свойство Value для CommandGroup или OptionGroup используется для
определения какая клавиша вызвала появление события и возвращает ее номер.
Допустимые типы значений свойства Value для объектов:
15
CheckBox
- Integer, Logical, Numeric.
ComboBox
- Character, Integer, Numeric.
CommandGroup
- Character, Integer, Numeric
EditBox
- Character, Memo
ListBox
- Character, Integer, Numeric
OptionButton
- Integer, Logical, Numeric
OptionGroup
- Character, Integer, Numeric
Grid
- Character, Numeric.
Spinner
- Currency, Integer, Numeric
Visible - определяет видим объект или нет. Данное свойство доступно как во
время разработки так и выполнения.
Синтаксис:
Object.Visible[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
( по умолчанию в окне дизайнера форм ) объект видим
False (.F.)
( по умолчанию при програмировании ) объект скрыт.
Форма не становится активной, если свойство Visible устанавливается в true
(.T.). Необходимо вызвать метод show.
WhatsThisHelpID - определяет ID номер топика файла помощи для получения
справки типа "что это". Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Object.WhatsThisHelpID[ = nContextID]
nContextID - имеет следующие допустимые значения:
отрицательные
- топик помощи отсутствует.
нуль
- ищется и если есть то выводится топик ближайшего
объекта.
положительное
- указывает номер топика объекта.
Width - определяет ширину объекта. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис: [Object.]Width[ = nWidth]
nWidth - задает ширину объекта.
Для формы данная величина не включает рамку.
2.1.3. События класса CheckBox
Click - происходит при нажатии и отпускании левой кнопки мыши или при
нажатии определенной комбинации клавиш.
Синтаксис:
PROCEDURE Object.Click
[LPARAMETERS nIndex]
nIndex - уникальный идентификатор объекта, если он входит в множество объектов .
DblClick - происходит при двойном нажатии и отпускании левой кнопки мыши.
Синтаксис:
PROCEDURE Object.DblClick
[LPARAMETERS nIndex]
nIndex - данный параметр описан выше.
Destroy - имеет место, когда освобождается объект.
Синтаксис:
PROCEDURE Object.Destroy
[LPARAMETERS nIndex]
nIndex - данный параметр описан выше.
16
DragDrop - когда завершается операция "перенести-и-оставить".
Синтаксис:
PROCEDURE Object.DragDrop
LPARAMETERS [nIndex,] oSource, nXCoord, nYCoord
nIndex - данный параметр описан выше.
oSource
- указывает какой объект переносится.
nXCoord, nYCoord
- содержат текущие горизонтальные (nXCoord) и
вертикальные (nYCoord) координаты курсора мыши, наведеного на конечный объект
переноса.
DragOver - имеет место, когда элемент управления, переносимый с помощью
мыши, накрывает объект назначения.
Синтаксис:
PROCEDURE Object.DragOver
LPARAMETERS [nIndex,] oSource, nXCoord, nYCoord, nState
nIndex, oSource, nXCoord, nYCoord - данные параметры описаны выше.
nState
- содержит число, представляющее переходное состояние переносимого
объекта в связи конечным объектом. Имеет следующие допустимые значения:
0 Enter.
- ввод. Объект переносится в пределах диапозона цели.
1 Leave.
- вывод. Объект переносится вне пределов диапозона цели.
2 Over.
- внутри. Объект переносится из одной позиции объекта- цели к
другой.
Используйте nState для задания действий в точках перехода. Например, вы
можете выделить возможный объект-цель при nState = 0 (Enter) и восстановить его
вид при nState = 1 (Leave).
Когда у объекта наступает событие DragOver с nState = 0 (Enter), то
происходит:
· вызывается событие DragDrop если исходный объект перенесен на конечный
объект.
· вызывается другое событие DragOver с nState = 1 (Leave), если исходный
объект все-таки не перенесен на конечный объект.
Объект, находящийся под переносимой иконкой - это объект-цель и он
вызывает событие DragOver.
Error - происходит при возникновении ошибки.
Синтаксис:
PROCEDURE Object.Error
LPARAMETERS [nIndex,] nError, cMethod, nLine
nIndex - уникальный идентификатор объекта, если он входит в множество объектов .
nError
- содержит номер ошибки Visual FoxPro.
cMethod
- содержит имя метода, вызвавшего ошибку.
nLine
- содержит номер строки метода, вызвавшего ошибку.
ErrorMessage - используется для определения сообщения об ошибке, когда
событие Valid возвращает значение (.F.).
Включено для совместимости с FoxPro 2.x. Используйте событие Valid.
GotFocus - имеет место, когда объект получает фокус в результате действий
пользователя или выполнения программного кода.
Синтаксис:
PROCEDURE Object.GotFocus
[LPARAMETERS nIndex]
nIndex - данный параметрй описан выше.
17
Объект может получить фокус, если его свойства Enabled и Visible
установлены в (.T.).
Событие
GotFocus происходит и после события Activate для объекта,
содержащего данный объект .
Init - имеет место при создании объект, когда объект еще не выведен на экран.
Синтаксис:
PROCEDURE Object.Init
[LPARAMETERS Param1, Param2,...]
Param1, Param2... - не обязательные параметры пользователя.
InteractiveChange - происходит при изменении значения элемента управления с
помощью клавиатуры или мыши.
Синтаксис:
PROCEDURE Control.InteractiveChange
[LPARAMETERS nIndex]
nIndex - уникальный идентификатор объекта, если он входит в множество
объектов .
KeyPress - происходит при нажатии и отпускании клавиши.
Синтаксис:
PROCEDURE Object.KeyPress
LPARAMETERS [nIndex,] nKeyCode, nShiftAltCtrl
nIndex - данный параметр описан выше.
nKeyCode - содержит число, определяющее нажатую клавишу. Для определения
его характеристик используйте INKEY( ).
nShiftAltCtrl
- устанавливает бит, если совместно нажата клавиша SHIFT, CTRL
или ALT:
SHIFT
1
CTRL
2
ALT
4
Данный параметр это сумма бит, определяющих одновременно нажатые
клавиши.
Только объект,имеющий фокус получет это событие.
Форма получает событие KeyPress если:
· форма не содержит видимых или активных объектов.
· свойство формы KeyPreview равно true (.T.).
· когда объект на форме не может отследить нажатие клавиши.
Событие KeyPress не происходит для любых комбинаций с клавишей ALT .
LostFocus - имеет место, когда объект теряет фокус.
Синтаксис:
PROCEDURE Object.LostFocus
[LPARAMETERS nIndex]
nIndex - данный параметр описан выше.
Время появления данного события зависит от объекта:
· объект теряет фокус при действиях пользователя (переключение на другой
объект или используя метод SetFocus). Объект Grid теряет фокус когда пользователь
нажимает CTRL+TAB в Windows или CONTROL+TAB в Macintosh для выхода из
Grid.
· форма теряет фокус только когда не имеет активных или видимых объектов.
Для форм событие LostFocus происходит перед событием Deactivate.
Message - отображает сообщение в строке состояния, когда объект получает
управление.
18
Включено для совместимости. Используйте свойство StatusBarText.
MiddleClick - происходит при нажатии средней кнопки мыши, если она есть.
Синтаксис:
PROCEDURE Control.MiddleClick
[LPARAMETERS nIndex]
nIndex - уникальный идентификатор объекта, если он входит в множество объектов .
MouseDown - происходит при нажатии кнопки мыши.
Синтаксис:
PROCEDURE Object.MouseDown
[LPARAMETERS nIndex, nButton, nShift, nXCoord, nYCoord]
или
LPARAMETERS nButton, nShift, nXCoord, nYCoord
nIndex - данный параметр описан выше.
nButton - содержит номер, указывающий нажатую кнопку: 1 (левая), 2 (правая), or
4 (средняя).
nShift
- содержит номер, указывающий совместно нажатой клавиши SHIFT,
CTRL и ALT:
SHIFT
1
CTRL
2
ALT
4
При одновременном нажатии нескольких клавиш nShift возвращает сумму их
значений.
nXCoord, nYCoord
- содержат текущие горизонтальные (nXCoord) и
вертикальные (nYCoord) координаты курсора мыши.
MouseMove - происходит при перемещении указателя мыши по объекту.
Синтаксис:
PROCEDURE Object.MouseMove
[LPARAMETERS nIndex, nButton, nShift, nXCoord, nYCoord]
или
LPARAMETERS nButton, nShift, nXCoord, nYCoord
nIndex, nButton, nShift, nXCoord, nYCoord - данные параметры описаны выше.
MouseUp - происходит при отпускании кнопки мыши.
Синтаксис:
PROCEDURE Object.MouseUp
[LPARAMETERS nButton, nShift, nXCoord, nYCoord]
или
LPARAMETERS nIndex, nButton, nShift, nXCoord, nYCoord
nIndex, nButton, nShift, nXCoord, nYCoord - данные параметры описаны выше.
MouseWheel - происходит при вращении колесика мыши, если мышь его
содержит.
Синтаксис:
PROCEDURE Object.MouseWheel
LPARAMETERS [nIndex,] nDelta, nShift, nXCoord, nYCoord
nIndex - уникальный идентификатор объекта, если он входит в множество объектов .
nDelta
- содержит число, показывающее дистанцию вращения колеса. Если
положительно, то колесо вращается вперед, если отрицательно, то назад.
nShift
- содержит номер, указывающий совместно нажатой клавиши SHIFT,
CTRL и ALT:
SHIFT
1
CTRL
2
ALT
4
При одновременном нажатии нескольких клавиш nShift возвращает сумму их
значений.
19
nXCoord, nYCoord
- содержат текущие горизонтальные (nXCoord) и
вертикальные (nYCoord) координаты курсора мыши.
OLECompleteDrag - происходит когда данные перенесены при OLE переносе
или эта операция отменена.
Синтаксис:
PROCEDURE Object.OLECompleteDrag
LPARAMETERS nEffect
nEffect - имеет следующие допустимые значения:
0
- данные не приняты или операция отменена.
1
- данные копированны.
2
- данные перемещены.
3
- с данными установлена связь.
OLEDragDrop - происходит когда данные перенесены к конечному объекту и у
него свойство OLEDropMode установлено в 1 – Enabled.
Синтаксис:
PROCEDURE Object.OLEDragDrop
LPARAMETERS oDataObject, nEffect, nButton, nShift,
oDataObject - объект,указывающий на переносимые данные и используемый для
определения формата данных в методах GetData и GetFormat.
nEffect, nButton, nShift, nXCoord, nYCoord - имеют значения, описанные в
предыдущих событиях.
Событие OLEDragDrop происходит только когда свойство OLEDropMode
установлено в 1 – Enabled.
OLEDragOver - имеет место, когда элемент управления, переносимый с
помощью мыши, накрывает объект назначения, а его свойство OLEDropMode
установлено в 1 – Enabled.
Синтаксис:
PROCEDURE Object.OLEDragOver
LPARAMETERS oDataObject, nEffect, nButton, nShift,
nXCoord, nYCoord, nState
oDataObject, nEffect, nButton, nShift, nXCoord, nYCoord - имеют значения,
описанные в предыдущих событиях.
nState
- содержит число, представляющее переходное состояние переносимого
объекта в связи конечным объектом. Имеет следующие допустимые значения:
0.
- ввод. Объект переносится в пределах диапозона цели.
1.
- вывод. Объект переносится вне пределов диапозона цели.
2.
- внутри. Объект переносится из одной позиции объекта- цели к
другой.
Используйте nState для задания действий в точках перехода. Например, вы
можете выделить возможный объект-цель при nState = 0 (Enter) и восстановить его
вид при nState = 1 (Leave).
OLEGiveFeedback - происходит после каждого события OLEDragOver.
Позволяет исходному объекту задавать тип операции OLE переноса.
Синтаксис:
PROCEDURE Object.OLEGiveFeedback
LPARAMETERS nEffect, eMouseCursor
nEffect - имеет значение, описанное в предыдущих событиях.
eMouseCursor - задает курсор мыши в течении операции OLE переноса. Это может
быть файл .ani, .cur, or .ico или специальное численное значение
20
OLESetData - происходит с исходным объектом переноса, когда объект-цель
вызывает метод GetData, а данные не представлены в нужном формате.
Синтаксис:
PROCEDURE Object.OLESetData
LPARAMETERS oDataObject, eFormat
oDataObject - имя объекта.
eFormat - числовое или строковое значение, указывающее формат данных, который
требует метод GetData.
OLEStartDrag - происходит когда вызывается метод OLEDrag.
Синтаксис:
PROCEDURE Object.OLEStartDrag
LPARAMETERS oDataObject, nEffect
oDataObject, nEffect - данные параметры описаны выше.
ProgrammaticChange - имеет место при изменении в коде значения элемента
управления.
Синтаксис:
PROCEDURE Control.ProgrammaticChange
[LPARAMETERS nIndex]
nIndex - уникальный идентификатор объекта, если он входит в множество объектов .
RightClick - происходит при нажатии и отпускании правой кнопки мыши.
Синтаксис:
PROCEDURE Control.RightClick
[LPARAMETERS nIndex]
nIndex - данный параметр описан выше.
ShowWhatsThis - отображает тему справочной системы, заданную для объекта
свойством WhatsThisHelpID.
Синтаксис:
Object.ShowWhatsThis
Object - имя объекта для которого вызывается справка.
Данный метод автоматически вызывается когда пользователь нажимает
клавишу F1. Если свойство WhatsThisHelp установлено в true (.T.) вызывается
справка установленная в свойстве WhatsThisHelpID, иначе вызывается контексная
справка, указанная в свойстве HelpContextID.
UIEnable - имеет место для объектов, содержащихся внутри объекта Page,
каждый раз, когда объект Page активизируется и деактивизируется.
Синтаксис:
PROCEDURE Object.UIEnable
[LPARAMETERS nIndex, lEnabled]
или
PROCEDURE Object.UIEnable
LPARAMETERS lEnabled
nIndex - уникальный идентификатор объекта, если он входит в множество объектов .
lEnabled
- содержит логическое значение, указывающее активна ли страница, на
которой расположен объект:
true (.T.)
- страница активизируется.
false (.F.)
- страница деактивизируется.
Valid - имеет место перед тем, как элемент управления теряет фокус.
Синтаксис:
PROCEDURE Control.Valid
[LPARAMETERS nIndex]
Если событие Valid возвращает true (.T.), объект теряет фокус, если возвращает
false (.F.) объект не теряет фокус.
Также событие Valid может вернуть численную величину:
· 0 если объект не теряет фокус.
21
· положительное число, указывающее номер следующего объекта,
получившего фокус.
· отрицательное число, указывающее номер предидущего объекта, получившего
фокус.
Например если событие Valid вернуло –1, то предидущий объект получил
фокус.
When - имеет место перед тем, как элемент управления получает фокус.
Синтаксис:
PROCEDURE Control.When
[LPARAMETERS nIndex]
Если событие When вернуло true (.T.), фокус получил объект по умолчанию, а
если When вернуло false (.F.), объект не получил фокус. Порядок событий при
получении фокуса:
1.
событие When
2.
событие GotFocus
Для объекта ListBox событие When происходит всякий раз, когда пользователь
перемещает фокус между элементами списка.
Для остальных объектов событие When происходит когда возникает попытка
сделать перемещение фокуса к объекту.
2.1.4. Методы класса CheckBox
AddProperty - добавляет новое свойство в объект.
Синтаксис:
Object.AddProperty(cPropertyName [, eNewValue])
cPropertyName - имя нового свойства.
eNewValue - указывает значение, присваемое данному свойству.
Новое свойство добавляется как свойство PUBLIC, т.е. общедоступное.
CloneObject - дублирует объект включая все его свойства, события и методы.
Данный метод доступен только во время разработки.
Синтаксис:
Object.CloneObject(NewName)
NewName - задает имя нового или дублирующего объекта.
Drag - начинает, оканчивает или отменяет операцию переноса объекта .
Синтаксис:
Control.Drag [(nAction)]
nAction - задает действие для выполнения. При отсутствии параметра nAction он
устанавливается в 1.
Имеет следующие допустимые значения:
0
- отменяет операцию переноса и восстанавливает действительную
позицию объекта.
1
( по умолчанию) Начинает перенос объекта.
2
оканчивает перенос, т.е. бросает объект.
Обычно событие MouseDown вызывает метод Drag для начала операции
переноса.
Необходимо использовать метод Drag для переноса объекта только когда
свойство DragMode установлено в 0 (Ручное). Вы можете использовать метод Drag
для объектов у которых DragMode установлено в 1 (Automatic), но тогда события
MouseDown и MouseUp не вызываются.
Move - перемещает объект.
Синтаксис:
Object.Move (nLeft [, nTop [, nWidth [, nHeight]]])
22
nLeft - содержит координаты по горизонтали левого края объекта.
nTop - содержит координаты по вертикали верхнего края объекта.
nWidth - содержит новую величину ширины объекта.
nHeight - содержит новую величину высоты объекта.
OLEDrag - запускает операцию OLE переноса.
Синтаксис:
PROCEDURE Object.OLEDrag
LPARAMETERS lDetectDrag
lDetectDrag - указывает когда событие OLEStartDrag выполнено. Значение false (.F.) оно еще идет, а значение true (.T.) - событие OLEStartDrag почти выполнилось.
ReadExpression - возвращает выражение, введенное в качестве значения
свойства в окне форм. Данный метод доступен как во время разработки так и
выполнения.
Синтаксис:
Object.ReadExpression(cPropertyName)
cPropertyName - указывает имя свойства, возвращающего выражение.
ReadMethod - возвращает текст заданного метода. Данный метод доступен
как во время разработки так и выполнения.
Синтаксис:
Control.ReadMethod(cMethod)
cMethod указывает имя метода.
Refresh - перерисовывает объект форму или объект и обновляет все значения.
Синтаксис:
[Form.]Object.Refresh
Обычно перерисовывание формы или объекта случается автоматически, когда
не происходят события, а метод Refresh применяется для немедленного обновления.
Когда обновляется форма, то обновляются и объекты формы. А когда
обновляется объекты Page обновляется только активная страница.
ResetToDefault - восстанавливает принятые по умолчанию в Visual FoxPro
значение свойства, событие или метод. Данный метод доступен как во время
разработки так и выполнения.
Синтаксис:
[Form.]Object.ResetToDefault(cPropertyName
| cEventName | cMethodName)
cPropertyName указывает имя свойства, значение которого сбрасывается в значение
Visual FoxPro по умолчанию.
cEventName - указывает имя события, значение которого сбрасывается в значение
по умолчанию, при этом весь код пользователя в этом событии уничтожается.
cMethodName - указывает имя метода, значение которого сбрасывается в значение
по умолчанию, при этом весь код пользователя в этом методе уничтожается.
SaveAsClass - сохраняет экземпляр объекта в качестве определения класса в
библиотеке класса.
Синтаксис:
Object.SaveAsClass.(ClassLibName, ClassName [, Description])
ClassLibName - указывает имя файла .VCX в котором хранится определение класса.
ClassName - указывает имя,присвоенное классу.
Description - содержит описание класса.
Метод SaveAsClass используется только для классов, приосходящих из
библиотеки классов (.VCX).
SetFocus - устанавливает фокус в элементе управления.
Синтаксис:
Control.SetFocus
23
Невозможно установить фокус для объекта, если его свойство Enabled или
Visible установлено в false (.F.) или событие When возвращает false (.F.),
необходимо установить эти свойства в true (.T.).
Когда объект имеет фокус действия пользователя непосредственно
обрабатываются объектом.
WriteExpression - записывает символьную строку в таблицу свойств. Данный
метод доступен как во время разработки так и выполнения.
Синтаксис:
Object.WriteExpression[cPropertyName, cExpression]
cPropertyName - определяет имя свойства, в которое вносится выражение.
cExpression - указывает символьную строку, которая записывается в свойство как
выражение.
WriteMethod - записывает указанный текст в заданный метод. Данный метод
доступен только во время разработки.
Синтаксис:
Control.WriteMethod(MethodName, MethodText)
MethodName - определяет имя метода в который записывается искомый текст.
MethodText - задает текст, записываемый в метод.
Этой метод устанавливает текст метода только для существующих методов,
иначе генерируется ошибка.
ZOrder - помещает заданный объект Form или элемент управления в заданную
позицию данного объекта по отношению к другим объектам. Помещает объект,
входящий в объект ToolBar на передний или задний план массива объектов,
определяющих порядок в котором объекты появляются в объекте ToolBar.
Синтаксис:
[Object.]ZOrder([nOrder])
nOrder задает целое число, указывающее позицию связи объекта к другим объектам.
При отсутствии параметра nOrder он устанавливается в 0.
Имеет следующие допустимые значения:
0
( по умолчанию ) Объект располагается впереди z-прорядка.
1
Объект располагается сзади z-прорядка.
Существует два слоя, связанных с объектами. Задний слой это область
рисования, где появляется результат работы графических объектов, а передний - это
слой самого объекта. Содержимое первого слоя покрывает содержимое заднего.
Метод ZOrder связан только с объектами в пределах слоя, где они появляются.
Для объекта Page метод ZOrder не затрагивает свойства PageOrder, а только
определяет какой объект Page наверху и активен.
2.2. Класс ComboBox
2.2.1. Использование класса ComboBox
Данный класс является визуальным и неконтейнером. Он представляет собой
раскрывающийся список. Когда данный объект выбран, то на экране появляется
список элементов, из которых можно выбрать одно. С помощью определенных
методов можно изменять данный список, непосредственно вводить информацию и
выполнять другие различные операции. Класс ComboBox объединяет особенности
классов TextBox и ListBox.
Элемент списка может не отображаться на экране если перед ним стоит знак (\).
24
2.2.2. Свойства класса ComboBox
BorderColor - указывает цвет рамки объекта. Данное свойство доступно как во
время разработки так и выполнения.
Синтаксис:
Object.BorderColor[ = nColor]
nColor - задает цвет, например:
Цвет
В формате RGB
Величина
белый
255, 255, 255
16777215
черный
0, 0, 0
0
серый
192, 192, 192
12632256
Для text box или edit box свойство BorderColor действительно, только если
свойство SpecialEffect установлено в 1 - Plain.
Для получения значения цвета nColor используйте функцию RGB( ).
BorderStyle – задает стиль обрамления окна объекта. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
Object.BorderStyle[ = nStyle]
nStyle - для CommandGroup, EditBox, Image, Label, OptionGroup или TextBox имеет
следующие допустимые значения:
0 - None.
- отсутствует ( по умолчанию для Image, Label).
1 - Fixed Single.
- неизменяемая одинарная рамка. ( по умолчанию для
CommandGroup, EditBox, OptionGroup, TextBox, ComboBox).
nStyle - для line или shape имеет следующие допустимые значения:
0
Transparent.
- прозрачная
1
(Default) Solid. - по умолчанию непрерывная.
2
Dash
- тире.
3
Dot
- точка.
4
Dash-Dot
- точка-тире.
5
Dash-Dot-Dot
- точка-тире-точка.
nStyle - для Form имеет следующие допустимые значения:
0
No border
- форма не имеет рамки.
1
Fixed Single
- неизменяемая одинарная рамка.
2
Fixed Dialog
- неизменяемая двойная рамка.
3
(Default) Sizable
- ( по умолчанию )изменяемая рамка(ее размеры
можно изменять при выполнении).
BoundColumn - определяет какая из колонок связана со значением свойства
Value объектов combo box или list box. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Control.BoundColumn[ = nCol]
nCol - указывает данный номер.
BoundTo - указывает когда свойство Value объектов combo box или list box
определяется свойствами List или ListIndex. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
[Form.]Control.BoundTo[ = lExpression]
lExpression - имеет следующие допустимые значения:
.T.
свойство Value определяется свойством List.
25
.F.
( по умолчанию) Свойств Value определяется в зависимости от типа
данных указанных в свойстве ControlSource т.е. если оно символьное, то свойство
Value определяется свойством List иначе оно определяется свойством ListIndex.
ColumnCount - задает число объектов Column для объектов Grid, ComboBox
или ListBox. Для grid данное свойство доступно во время разработки и только для
чтения-записи при выполнении. Для combo box или list box данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
Object.ColumnCount[ = nCol]
nCol - для Grid задает число объектов column. По умолчанию это значение –1, чио
указывает что объект Grid должен содержать достаточно колонок, чтобы вместить
все поля источника данных.
nCol - для ComboBox или ListBox задает число колонок. Если установить
ColumnCount равным 0 то первая колонка отображается основываясь на свойстве
RowSource или на элементах, добавляемых методом AddItem.
Для grid используйте метод AddColumn для увеличения числа колонок.
ColumnLines - показывает или скрывает линии между колонками. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.ColumnLines[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
( по умолчанию ) Линии изображаются.
False (.F.)
Линии скрываются.
ColumnWidths - задает ширину колонок для ComboBox или ListBox. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис: Control.ColumnWidths[ = “cCol1Width, cCol2Width, ... cColnWidth”]
“cCol1Width, cCol2Width, ... cColnWidth” - задает ширину колонок для каждой из
них.
DisabledItemBackColor - задает фоновый цвет для неактивных элементов
объектов ComboBox или ListBox. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Control.DisabledItemBackColor[ = nColor]
или
Control.DisabledItemBackColor RGB(nRedValue, nGreenValue, nBlueValue)
nColor - задает число, определяющее цвет.
DisabledItemForeColor - задает цвет для неактивных элементов объектов
ComboBox или ListBox. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Control.DisabledItemForeColor[ = nColor]
или
Control.DisabledItemForeColor RGB(nRedValue, nGreenValue, nBlueValue)
DisplayValue - определяет содержимое первой колонки выбранного элемента
объектов ListBox или ComboBox. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
[Form.]Control.DisplayValue[ = Expr]
Expr - если DisplayValue строка символов, то определяет значение первой колонки
выбранного элемента, а если DisplayValue число, то определяет индекс выбранного
элемента.
Используйте свойство DisplayValue когда объект ComboBox или ListBox имеет
более одной колонки и значение свойства BoundColumn более 1. Когда свойство
26
DisplayValue строка символов, то эти символы изображаются в текстовой части
объекта ComboBox.
Когда ComboBox или ListBox имеют только одну колонку то свойства
DisplayValue и Value имеют одинаковое значение если содержат символьную строку.
FirstElement – задает первый элемент массива, который будет отображаться в
объекте ComboBox или ListBox. Данное свойство доступно как во время разработки
так и выполнения.
Синтаксис:
Control.FirstElement[ = nElement]
nElement - задает данный элемент.
Данное свойство доступно только в том случае, если свойство RowSource задает
в качестве источника данных массив (RowSourceType=5 ).
Format - указывает формат ввода и вывода свойства объекта Value. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.Format[ = cFunction]
cFunction - для EditBox имеет следующие допустимые значения:
K
- выделяет весь текст, когда объект получает фокус
cFunction - для Spinner имеет следующие допустимые значения:
$
- изображает данный денежный символ.
^
- изображает числовые данные, используя научное представление.
K
- выделяет весь текст, когда объект получает фокус
L
- изображает продвижение нулей (вместо пробелов) в текстовой области.
R
- изображает маску ввода для текстовой области, определенную в
свойстве InputMask.( например если маска 99-999 то число 12345 выглядит так 12345). Используется только с числами и хранится как целое число.
Z
- изображает значение незаполненым, если оно равно нулю когда объект
не имеет фокус.
cFunction - для TextBox и Column имеет следующие допустимые значения:
!
- преобразует буквы в прописные.
$
- изображает данный денежный символ.
^
- изображает числовые данные, используя научное представление.
K
- выделяет весь текст, когда объект получает фокус
L
- изображает продвижение нулей (вместо пробелов) в текстовой области.
R
- изображает маску ввода для текстовой области, определенную в
свойстве InputMask.( например если маска 99-999 то число 12345 выглядит так 12345). Используется только с числами и хранится как целое число.
Z
- изображает значение незаполненым, если оно равно нулю когда объект
не имеет фокус.
A
- ввод только букв без пробелов и знаков препинания.
D
- использует текущий формат SET DATE.
E
- редактирует дату как британскую.
M
- включено для совместимости.
T
- урезает пробелы во вводимом поле.
YS
- изображает дату в коротком формате используя установки Windows.
YL
- изображает дату в длинном формате используя установки Windows.
Можно использовать несколько кодов одновременно.
27
HideSelection - определяет, выделяется ли текст когда объект теряет фокус.
Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.HideSelection[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
( по умолчанию) - текст выделяется.
False (.F.)
- текст не выделяется.
IncrementalSearch - указывает использует ли объект возрастающий поиск, т.е.
если вы ищете слово “ELASTIC” вы можете набрать буквы E-L-A и Visual FoxPro
найдет слово с данными буквами. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Control.IncrementalSearch[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
( по умолчанию ) Поиск поддерживается.
False (.F.)
Поиск не поддерживается.
InputMask - указывает как вводятся и изображаются данные в объекте. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.InputMask[ = cMask]
cMask - имеет следующие допустимые значения:
X
вводятся любые символы.
9
вводятся только цифры и знаки.
#
вводятся только цифры, пробелы и знаки.
$
изображается данный символ в определенной позиции.
$$
данный символ добавляется к цифрам в объекте spinner или text box.
*
слева от символов изображаются звездочки.
.
указывается десятичная точка.
,
запятая разделяет цифры слева десятичной точки.
ItemBackColor - определяет фоновый цвет для элементов объектов ComboBox
или ListBox. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.ItemBackColor[ = nColor]
или
Control.ItemBackColor = RGB(nRedValue, nGreenValue, nBlueValue)
nColor - задает данный цвет.
ItemData - позволяет использовать индексы для связывания значений
одномерного массива с элементами объектов combo box или list box. Используется
только если объект содержит менее 60 элементов. Не доступно во время
програмирования; только для чтения-записи при выполнении.
Синтаксис:
Control.ItemData(nIndex)[ = nData]
nIndex - определяет номер элемента и задает порядок элементов в списке.
nData - новый номер.
Данное свойство может например использоваться для определения выбранного
элемента из списка.
ItemForeColor - определяет цвет для элементов объектов ComboBox или
ListBox. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.ItemForeColor[ = nColor]
или
Control.ItemForColor = RGB(nRedValue, nGreenValue, nBlueValue)
ItemIDData - данное свойство аналогично свойству ItemData.
28
List - массив символьных строк, используемый для доступа к элементам в
объектах ComboBox или ListBox. Не доступно во время програмирования; только
для чтения-записи при выполнении.
Синтаксис:
Control.List(nRow [, nCol])[ = cChar]
nRow - определяет номер столбца элементов, содержащийся в списке.
nCol - определяет номер строки элементов, содержащийся в списке. по умолчанию
выбирается первый столбец.
Свойство
List работая совместно со свойством ListCount позволяет
организовать доступ ко всем элементам списка с первого до последнего, т.е.
ListCount.
ListCount - содержит число элементов в списке объекта ComboBox или ListBox.
Не доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Control.ListCount
ListIndex - указывает индекс выбранного элемента в списке объекта ComboBox
или ListBox. Не доступно во время програмирования; только для чтения-записи при
выполнении.
Синтаксис:
Control.ListIndex[ = nIndex]
nIndex - имеет следующие допустимые значения:
0
( по умолчанию ) сообщает что ничего не выбрано. Для combo box это
значит что полльзователь ввел значение не входящее в список.
1 ... ListCount
- номер выбранного индекса.
ListItem - массив символьных строк, используемый для доступа к элементам в
объектах ComboBox или ListBox согласно их ID.
Не доступно во время
програмирования; только для чтения-записи при выполнении.
Синтаксис:
Control.ListItem(nItemID)[ = cChar]
nItemID - указывает элемент, используя уникальный ID элемента.
ListItemID - хранит уникальный ID номер для выбранного элемента объектов
ComboBox или ListBox. Не доступно во время програмирования; только для чтениязаписи при выполнении.
Синтаксис:
Control.ListItemID[ = nItemID]
nItemID - имеет следующие допустимые значения:
–1
- сообщает что ничего не выбрано. Для combo box это значит что
пользователь ввел значение не входящее в список.
1 ... ListCount
- ID номер выбранного индекса.
Margin - указывает ширину текстовой области объекта. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
Control.Margin[ = nValue]
nValue - содержит данную величину.
NewIndex - указывает индекс последнего добавленного элемента. Не доступно
во время програмирования; только для чтения при выполнении.
Синтаксис:
Control.NewIndex
NewItemID - указывает ID индекс последнего добавленного элемента. Не
доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
[Form.]Control.NewItemID
NumberOfElements - определяет количество элементов массива, отображаемых
в списке. Данное свойство доступно как во время разработки так и выполнения.
29
Синтаксис:
[Form.]Control.NumberOfElements[ = nTotal]
nTotal -указывает число элементов.
Данное свойство доступно только в том случае, если свойство RowSource задает
в качестве источника данных массив (RowSourceType=5 ).
RowSource - указывает источник данных списка. Данное свойство доступно
как во время разработки так и выполнения.
Синтаксис:
Control.RowSource[ = cName]
cName - указывает источник(запрос, величины, массив или файлы *.DBF или *.TXT)
RowSourceType - определяет тип источника данных. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
Control.RowSourceType[ = nSource]
nSource - имеет следующие допустимые значения:
0
- ( по умолчанию )значения элементов списка определяются програмно,
используя методы AddItem или AddListItem.
1
- список задается в виде строки, элементы в которой разделяются
запятыми.
2
- в качестве источника данных используется таблица. Количество
выводимых полей таблицы определяется значением свойства ColumnCount
3
- список содержит данные, полученные в результате выполнения SQLоператора.
4
- список содержит данные, полученные в результате выполнения
указанного запроса. Запрос задается именем файла с расширением .QPR
5
- источником данных является задданый массив.
6
- значения элементов списка определяются полями таблицы.
7
- список содеожит перечень файлов текущего каталога. Вы можете
задать в свойстве RowSource шаблон выбора файлов.
8
- в качестве источника данных используется структура таблицы.
9
- список содержит пункты всплывающего меню. Для совместимости..
Selected - указывает выбран ли элемент в списке. Не доступно во время
програмирования; только для чтения-записи при выполнении.
Синтаксис:
[Form.]Control.Selected(nIndex)[= lExpr]
nIndex - указывает данный индекс.
lExpr - имеет следующие допустимые значения:
True (.T.)
элемент выбран.
False (.F.)
( по умолчанию) элемент не выбран.
SelectedBackColor - задает цвет фона для выбранного текста. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
Control.SelectedBackColor[ = nColor]
или
Control.SelectedBackColor RGB(nRedValue, nGreenValue, nBlueValue)
nColor - задает данный цвет
SelectedForeColor - задает цвет для выбранного текста. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
Control.SelectedForeColor[ = nColor]
или
Control.SelectedForeColor RGB(nRedValue, nGreenValue, nBlueValue)
SelectedID - аналогично свойству Selected, но оперирует ID индексами.
30
SelectedItemBackColor - задает фоновый цвет для выбранного элемента
объектов combo box или list box. Данное свойство доступно как во время разработки
так и выполнения.
Синтаксис:
Control.SelectedItemBackColor[ = nColor]
или
Control.SelectedItemBackColor RGB(nRedValue, nGreenValue, nBlueValue)
SelectedItemForeColor - задает цвет для выбранного элемента объектов combo
box или list box. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Control.SelectedItemForeColor[ = nColor]
или
Control.SelectedItemForeColor RGB(nRedValue, nGreenValue, nBlueValue)
SelLength - возвращает число символов, выбранных пользователем в текстовой
области. Не доступно во время програмирования; только для чтения-записи при
выполнении.
Синтаксис:
[Form.]Control.SelLength[= nLength]
nLength - определяет данное число
SelStart - возвращает номер первого символа, выбранного пользователем
текста. Не доступно во время програмирования; только для чтения-записи при
выполнении.
Синтаксис:
[Form.]Control.SelStart[= nStart]
nStart - указывает данный номер.
SelText - возвращает выбранный пользователем текст или пустую строку, если
ничего не выбрано. Не доступно во время програмирования; только для записичтения при выполнении.
Синтаксис:
[Form.]Control.SelText[= cString]
cString - содержит данный текст.
Sorted - указывает сортируется ли список элементов объектов combo box или
list box. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
[Form.]Control.Sorted[= lExpr]
lExpr - имеет следующие допустимые значения:
.T.
- сортировка есть.
.F.
- сортировки нет.
Свойство доступно если свойство RowSourceType установлено в 0 (None) или 1
(Value).
Text Property - содержит не форматированный текст, введеный в текстовую
область объекта. Не доступно во время програмирования; только для чтения при
выполнении.
Синтаксис:
Object.Text
TopIndex - указывает элемент, появляющийся на верху списка. Не доступно во
время програмирования; только для чтения при выполнении.
Control.TopIndex[ = nIndex]
nIndex - хранит данный номер.
TopItemID - указывает ID элемента, появляющегося на верху списка.
доступно во время програмирования; только для чтения при выполнении.
Control.TopIItemID[ = nItemID]
Не
31
nIndexID - хранит данный номер.
Данные свойства класса описанны выше:
Alignment
BackColor
BackStyle
Class
ClassLibrary
ColorScheme
Comment
ControlSource DisabledBackColor
DragIcon
DragMode
Enabled
FontCondense
FontExtend
FontItalic
FontOutline
FontShadow
FontSize
FontUnderline ForeColor
Height
Left
MousePointer
Name
ParentClass
RightToLeft
SpecialEffect
TabIndex
TabStop
Tag
ToolTipText
Top
Visible
Style
ReadOnly
BaseClass
ColorSource
DisabledForeColor
FontBold
FontName
FontStrikeThru
HelpContextID
Parent
StatusBarText
TerminateRead
Width
2.2.3. События класса ComboBox
DownClick - происходит когда нажимается кнопка объекта "вниз".
Синтаксис:
PROCEDURE Control.DownClick
[LPARAMETERS nIndex]
nIndex - уникальный идентификатор объекта, если он входит в множество объектов .
DropDown - имеет место, когда после нажатия кнопки со стрелкой в объекте
ComboBox должен появиться список.
Синтаксис:
PROCEDURE ComboBox.DropDown
[LPARAMETERS nIndex]
nIndex - данный параметр описан выше.
RangeHigh - для объектов spinner или text box происходит когда объект теряет
фокус, а для combo box или list box случается когда объект получает фокус.
Синтаксис:
PROCEDURE Object.RangeHigh
[LPARAMETERS nIndex]
Событие RangeHigh может возвратить числовое значение Visual FoxPro,
используя RETURN. Для spinner или text box, использующих числовые значения,
если значение возвращенное Visual FoxPro меньше величины, введенной в объект ,
то объект теряет фокус. Для combo box или list box величина, возвращаемая Visual
FoxPro указывает выбранный элемент.
RangeLow - для объектов spinner или text box происходит когда объект теряет
фокус, а для combo box или list box случается когда объект получает фокус.
Синтаксис:
PROCEDURE Object.RangeLow
[LPARAMETERS nIndex]
Событие RangeLow может возвратить числовое значение Visual FoxPro,
используя RETURN. Для spinner или text box, использующих числовые значения,
если значение возвращенное Visual FoxPro больше величины, введенной в объект ,
то объект теряет фокус. Для combo box или list box величина, возвращаемая Visual
FoxPro указывает выбранный элемент.
UpClick - происходит когда нажимается кнопка объекта "вверх".
Синтаксис:
PROCEDURE Control.UpClick
[LPARAMETERS nIndex]
32
nIndex - уникальный идентификатор объекта, если он входит в множество
объектов.
Данные события класса описанные выше:
Click
DblClick
Destroy
DragDrop
DragOver
Error
ErrorMessage
GotFocus
Init
InteractiveChange
KeyPress
LostFocus
Message
MiddleClick
MouseDown
MouseMove
MouseUp
MouseWheel
ProgrammaticChange RightClick
UIEnable
Valid
When
2.2.4. Методы класса ComboBox
AddItem - добавляет новый элемент в объект ComboBox или ListBox, позволяя
задать индекс этого элемента.
Синтаксис:
Control.AddItem(cItem [, nIndex] [, nColumn])
cItem - задает строковое выражение для добавления в объект.
nIndex - указывает позицию, где помещается элемент. Если данный параметр
отсутствует и свойство Sorted установлено в true (.T.), то cItem добавляется в
алфавитном порядке иначе в конец.
nColumn - указывает колонку, в которую помещается новый элемент.
Используйте методы AddItem или AddListItem, когда свойство RowSourceType
установлено в 0 (None).
Каждый элемент, добавляемый в объекты ComboBox или ListBox имеет два
идентификационных номера:
· nItemID - число, ссылающееся на уникальный ID номер элемента в объекте:
первый элемент ссылается на nItemID = 1, если существует и другой номер nItemID.
· nIndex - число, определяющее порядок в котором элементы изображаются
объектом: первый элемент ссылается на nIndex = 1.
AddListItem - добавляет новый элемент в объект ComboBox или ListBox,
позволяя задать ID номер этого элемента.
Синтаксис:
Control.AddListItem(cItem [, nItemID] [, nColumn])
cItem - указывает элемент добавляемый в объект.
nItemID - задает число представляющее уникальный ID номер элемента для объекта.
nColumn - указывает колонку, в которую помещается новый элемент.
Используйте методы AddItem или AddListItem, когда свойство RowSourceType
установлено в 0 (None).
Clear - очищает содержимое объектов ComboBox или ListBox.
Синтаксис:
Object.Clear
Для работы метода Clear необходимо, чтобы свойство RowSourceType было
установлено в 0 (None).
IndexToItemID - возвращает ID номер элемента для заданного индекса этого
элемента (индекс показывает номер элемента в списке при его отображении).
Синтаксис:
[nItemID =] Control.IndexToItemID(nIndex)
nItemID - задает уникальный идентификационный номер.
nIndex - указывает число, представляющее позицию, на которой изображается
элемент в объекте.
33
Изначально элементы, добавляемые в объект имееют одинаковые индекс
элемента и ID номер, но со временем при добавлении, удалении и т.п. они
изменяются.
ItemIDToIndex - возвращает индекс, т.е. позицию на экране для данного
элемента, по его ID номеру. Данный метод обратный для метода IndexToItemID.
Синтаксис:
[nIndex =]Control.ItemIDToIndex(nItemID)
RemoveItem - удаляет элемент из объектов combo box или list box.
Синтаксис:
Control.RemoveItem(nIndex)
nIndex - указывает число, представляющее позицию, на которой изображается
элемент в объекте. Для первого элемента в объекте list box или combo box nIndex = 1.
RemoveListItem - удаляет элемент из объектов combo box или list box.
Синтаксис:
Control.RemoveListItem(nItemId)
nItemId - указывает уникальный идентификационный ID номер.
Requery - обновляет списки объектов ListBox или ComboBox.
Синтаксис:
Control.Requery
Используйте метод Requery чтобы удостоверится что объект содержит
последние данные.
Данные методы класса описанны выше:
ZOrder
CloneObject
Drag
Move
ReadExpression
ReadMethod
Refresh
ResetToDefault
SaveAsClass
SetFocus
UIEnable
WriteExpression
WriteMethod
2.3. Класс CommandButton
2.3.1. Использование класса CommandButton
Данный класс является визуальным и неконтейнером. Он представляет собой
кнопку управления, для которой можно задать разнообразные характеристики и
приспособить для выполнения различных операций, определить реакции на
различные действия над ней.
2.3.2. Свойства класса CommandButton
Cancel - указывает когда объект CommandButton или OLE Container являются
кнопкой отмены; т.е когда пользователь нажимает клавишу ESC то вызывается
событие Click кнопки отмены. Данное свойство доступно как во время разработки
так и выполнения.
Синтаксис:
Object.Cancel[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
Указанные объекты это кнопки отмены.
False (.F.)
( по умолчанию) Они не являются кнопками отмены.
Default - указывает реагируют ли объекты command button или OLE Container на
нажатие клавиши ENTER если активная форма имеет несколько кнопок. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.Default[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
Данные объекты реагируют на нажатие данной кнопки.
False (.F.)
( по умолчанию ) объекты не реагируют .
34
Только один объект command button или OLE Container для формы может
обладать данным свойством, установленым в true (.T.).
WordWrap Property - указывает когда объект Label расширяется вертикально
или горизонтально для того чтобы текст, определенный в свойстве Caption, заполнил
все пространство объекта при изменении его размеров. Данное свойство доступно
как во время разработки так и выполнения.
Синтаксис:
[Form.]Label.WordWrap[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
Горизонтальный размер не меняется. Меняется только
вертикальный размер.
False (.F.)
( по умолчанию) Горизонтальный размер меняется. Вертикальный
размер нет.
Если свойство WordWrap установлено в true (.T.) свойство AutoSize
игнорируется.
Данные свойства класса описаны выше:
AutoSize
BaseClass
Caption
Class
ClassLibrary
ColorScheme
ColorSource
Comment
DisabledForeColor
DisabledPicture
DownPicture
DragIcon
DragMode
Enabled
FontBold
FontCondense
FontExtend
FontItalic
FontName
FontOutline
FontShadow
FontSize
FontStrikeThru
FontUnderline
ForeColor
Height
HelpContextID
Left
MousePointer
Name Parent
ParentClass
Picture
RightToLeft
SpecialEffect
StatusBarText
Style
TabIndex
TabStop
Tag
TerminateRead
ToolTipText
Top
Visible
Width
2.3.3. События класса CommandButton
Данные события класса описанны выше:
Click
Destroy
Error
ErrorMessage
InteractiveChange
KeyPress
MiddleClick
MouseDown
MouseWheel
RightClick
When
DragDrop
GotFocus
LostFocus
MouseMove
UIEnable
2.3.4. Методы класса CommandButton
Данные методы класса описанны выше:
CloneObject
Drag
Move
ReadMethod
Refresh
ResetToDefault
SetFocus
WriteExpression
WriteMethod
2.4. Класс CommandGroup
2.4.1. Использование класса CommandGroup
DragOver
Init
Message
MouseUp
Valid
ReadExpression
SaveAsClass
ZOrder
35
Данный класс является визуальным и контейнером, т.е. он может содержать
другие объекты или другими словами классы. В данном случае этот класс
представляет собой набор кнопок управления, аналогичных классу CommandButton,
над которыми можно выполнять различные действия и задавать их параметры как по
отдельности, так и вместе.
2.4.2. Свойства класса CommandGroup
ButtonCount - указывает количество кнопок в объектах CommandGroup или
OptionGroup. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Control.ButtonCount[ = nNumber]
nNumber - задает количество кнопок.
Buttons - массив, организующий доступ к каждой кнопке объектов
CommandGroup или OptionGroup. Не доступно во время програмирования.
Синтаксис:
Control.Buttons (nIndex).Property = Value
или
Control.Buttons (nIndex).Method
nIndex - число между 1 и числом, указанным в свойстве ButtonCount, определяющее
номер кнопки.
Property - свойство объектов CommandButton или OptionButton.
Value - значение свойства.
Method - метод объекта CommandButton или OptionButton.
Данные свойства класса описанны выше:
AutoSize
BackColor
BackStyle
BaseClass
BorderColor
BorderStyle
Class
ClassLibrary
ColorSource
Comment
ControlSource
DragIcon
DragMode
Enabled
Height
HelpContextID
Left
MousePointer
Name
Parent
ParentClass
SpecialEffect
TabIndex
Tag
TerminateRead
Top
Value
Visible
Width
2.4.3. События класса CommandGroup
Данные события класса описанны выше:
Click
DblClick
DragDrop
Error
ErrorMessage
Init
Message
MiddleClick
MouseDown
MouseUp
MouseWheel
ProgrammaticChange
UIEnable
Valid
When
DragOver
InteractiveChange
MouseMove
RightClick
2.4.4. Методы класса CommandGroup
AddObject - добавляет объект в данный объект-контейнер в время выполнения.
Синтаксис:
Object.AddObject(cName, cClass [, cOLEClass] [, aInit1, aInit2 ...])
cName - задает имя нового объекта.
cClass - указывает класс добавляемого объекта.
cOLEClass - указывает OLE-класс добавляемого объекта.
aInit1, aInit2 - указывает параметры, передаваемые в событие Init нового объекта.
Свойство Visible нового объекта установлено в false (.F.)
36
RemoveObject - удаляет указанный объект из объекта-контейнера в время
выполнения.
Синтаксис:
Object.RemoveObject(cObjectName)
cObjectName - указывает имя объекта.
SetAll - присваивает установку некоторого свойства всем элементам управления
данного объекта Container или определенному классу таких элементов управления.
Синтаксис:
Container.SetAll(cProperty, Value [, cClass])
cProperty - задает устанавливаемое свойство.
Value - задает новое значение свойства.
cClass - указывает имя класса.
Данные методы класса описанны выше:
CloneObject
Drag
Move
ReadExpression
ReadMethod
Refresh
ResetToDefault
SaveAsClass
WriteExpression
WriteMethod
ZOrder
2.5. Класс Container
2.5.1. Использование класса Container
Данный класс является визуальным и контейнером, т.е. он может содержать
другие объекты или другими словами классы. В данном случае он используется
программистом для хранения других классов, в том числе созданных пользователем,
для обеспечения каких-либо целей и позволяет выполнять различные действия над
классами, изменять их параметры как по отдельности, так и вместе.
2.5.2. Свойства класса Container
ActiveControl – указывает активный объект данного объекта-контейнера. Не
доступно во время редактирования, только для чтения во время выполнения. Это
свойство не доступно если все объекты выбранного объекта невидимы или
выключенны. Если объект активен, свойство ActiveControl ссылается на объект
который имеет фокус, иначе ошибка.
Синтакс: Object.ActiveControl.Property[ = Value]
Property – свойство, которое возвращается или устанавливается.
Value – новое или текущего значение.
BorderWidth - задает ширину границы объекта.
Синтаксис:
Control.BorderWidth[ = nWidth]
nWidth - значение ширины ( от 0 до 8192).
Если значение свойства BorderWidth больше 1 то свойство BorderStyle
игнорируется.
ControlCount - указывает число объектов в данном объекте-контейнере. Не
доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Object.ControlCount
Controls - массив, организующий доступ к каждому объекту в данном объектеконтейнере.
Синтаксис:
ContainerObject.Controls(Index).Property[ = Expr]
Expr - указывает значение свойства для объекта, входящем в объект Container.
Данные свойства класса описанны выше:
37
BackColor
BackStyle
BaseClass
BorderColor
Class
DragIcon
Height
Name
TabIndex
Width
ClassLibrary
DragMode
HelpContextID
ParentClass
TabStop
ColorSource
Enabled
Left
Picture
Top
Comment
ForeColor
MousePointer
SpecialEffect
Visible
2.5.3. События класса Container
Resize - происходит при изменении размеров объекта.
Синтаксис:
PROCEDURE Object.Resize
[LPARAMETERS nIndex]
nIndex - уникальный идентификатор объекта, если он входит в множество объектов.
Moved
- имеет место при перещении объекта на новое место или когда
установки свойства Top или Left объекта-контейнера изменяются програмным
способом.
Синтаксис:
PROCEDURE Object.Moved
Данные события класса описанны выше:
Click
DblClick
Destroy
DragDrop
DragOver
Error
GotFocus
Init
LostFocus
MiddleClick
MouseDown
MouseMove
MouseUp
MouseWheel
RightClick
UIEnable
2.5.4. Методы класса Container
Draw - перерисовывает объект Form.
Синтаксис:
Object.Draw
Данные методы класса описанны выше:
AddObject
Drag
Move
RemoveObject
ResetToDefault
SaveAsClass
SetFocus
ZOrder
Refresh
SetAll
2.6. Класс Control
2.6.1. Использование класса Control
Данный класс является визуальным и неконтейнером и обычно используется
программистом как базовый класс для собственных классов. Он может содержать
другие объекты, но не является классом-контейнером, так как не может организовать
к ним доступ.
2.6.2. Свойства класса Control
Данные свойства класса описаны выше:
BackColor
BackStyle
BorderWidth
Class
Comment
ControlCount
DragMode
Enabled
BaseClass
ClassLibrary
Controls
ForeColor
BorderColor
ColorSource
DragIcon
Height
38
HelpContextID
ParentClass
TabStop
Left
Picture
Top
MousePointer
SpecialEffect
Visible
2.6.3. События класса Control
Данные события класса описаны выше:
Click
DblClick
Destroy
DragOver
Error
GotFocus
LostFocus
MiddleClick
MouseDown
MouseUp
MouseWheel
Moved
RightClick
UIEnable
2.6.4. Методы класса Control
Данные методы класса описаны выше:
Drag
Draw
ResetToDefault
SaveAsClass
Move
SetFocus
Name
TabIndex
Width
DragDrop
Init
MouseMove
Resize
Refresh
ZOrder
2.7. Класс Cursor
2.7.1. Использование класса Cursor
Данный класс отличается от обычных классов VisualFoxPro. Он создается когда
таблица или представление добавляется в окружение данных (data environment) для
объектов типа form, form set или в отчет и позволяет задавать свойства и связи этих
таблиц или отношений, в том числе некоторые и при выполнении.
При установке свойств объекта cursor во время выполнения приложения
выдается сообщение об ошибке (кроме свойств Filter и Order изменение которых
допускается ). Для того чтобы новые значения свойств вступили в действие
неоходимо вызвать методы CloseTables и OpenTables для класса data environment.
Также если во время работы программы изменяется свойство Order объекта cursor
влкюченного в представление один-ко-многим, то данное отношение теряется.
2.7.2. Свойства класса Cursor
Alias - указывает псевдоним, используемый для таблицы, ассоциированной с
объектом Cursor. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
DataEnvironment.Cursor.Alias[ = cText]
cText - указывает данный псевдоним.
BufferModeOverride - указывает когда игнорировать свойство BufferMode,
установленное для объектов form или form set. Данное свойство доступно как во
время разработки так и выполнения.
Синтаксис:
DataEnvironment.Cursor.BufferModeOverride[ = nValue]
nValue - имеет следующие допустимые значения:
0 - None.
- буферизация отсутствует.
1 - (Default) Use form Setting. - ( по умолчанию ) используется свойство
BufferMode соответствующего объекта form или form set.
39
2 - Pessimistic row buffering.
- блокирует запись и помещает в буфер
изменения пока не передвинется указатель записи.
3 - Optimistic row buffering.
- позволяет редактировать одиночную запись и
блокирует ее только когда она записывается на диск.
4- Pessimistic table buffering. - блокирует каждую редактированную запись, но
не записывает их на диск до вызова команды TABLEUPDATE( ).
5- Optimistic table buffering.
- позволяет редактировать все записи и не
блокирует каждую редактированную запись до вызова команды TABLEUPDATE( ).
CursorSource - задает имя таблицы или представления, связанного с объектом
Cursor. Только для чтения во время програмирования; только для чтения-записи при
выполнении.
Синтаксис:
DataEnvironment.Cursor.CursorSource[ = cText]
cText - задает данное имя.
Database - указывает путь к базе данных, содержащей таблицу или
представление, связанную с объектом Cursor. Только для чтения во время
програмирования; только для чтения-записи при выполнении.
Синтаксис:
DataEnvironment.Cursor.Database[ = cPath]
cPath - указывает данный путь к файлу (.DBC).
Для свободной таблицы это свойство пустая строка.
Exclusive - указывает когда таблица, ассоциированная с объектом Cursor,
открывается эксклюзивно. Данное свойство доступно во время разработки, только
для чтения-записи при выполнении.
Синтаксис:
DataEnvironment.Cursor.Exclusive[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
( по умолчанию ) таблица открывается эксклюзивно.
False (.F.)
таблица не открывается эксклюзивно.
Filter - исключает записи, не соответствующие заданному критерию. Данное
свойство доступно во время разработки, только для чтения-записи при выполнении.
Синтаксис:
DataEnvironment.Cursor.Filter[ = cExpr]
cExpr - выражение Visual FoxPro
NoDataOnLoad - определяет открывать ли представление, ассоциированное с
объектом Cursor, без загрузки данных. Данное свойство доступно во время
разработки, только для чтения-записи при выполнении.
Синтаксис:
DataEnvironment.Cursor.NoDataOnLoad[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
- загрузка данных при открытии не используется.
False (.F.)
( по умолчанию ) наоборот.
Order - используется для определения порядка вывода записей на экран.
Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
DataEnvironment.Cursor.Order[ = cTagName]
cTagName - указывает существующий индекс для таблицы.
Если установлено свойство ChildOrder объекта relation, то данное свойство
игнорируется.
Данные свойства класса описаны выше:
Name
ReadOnly
2.7.3. События и методы класса Cursor
40
Данные события и методы класса описаны выше:
Destroy
Error
Init
ResetToDefault
2.8. Класс Custom
2.8.1. Использование класса Custom
Данный класс является невизуальным и контейнером. Он применяется как
базовый класс для построения пользователем нужных ему невизуальных классовконтейнеров.
2.8.2. Свойства класса Custom
Данные свойства класса описаны выше:
BaseClass
Class
ClassLibrary
Height
Left
Name
ParentClass
Picture
Top
Comment
Parent
Width
2.8.3. События и методы класса Custom
Данные события и методы класса описаны выше:
Destroy
Error Init
AddObject
ReadExpression
ReadMethod
RemoveObject ResetToDefault SaveAsClass
WriteExpression
WriteMethod
ShowWhatsThis
2.9. Класс DataEnvironment
2.9.1. Использование класса DataEnvironment
Данный класс отличается от обычных классов VisualFoxPro. Он является
контейнером только для таких классов как Cursor и Relation, ассоциированных с
объектами типа form, form set или отчет.
При установке свойств объекта DataEnvironment во время выполнения
приложения выдается сообщение об ошибке. Для того чтобы новые значения
свойств вступили в действие неоходимо вызвать методы CloseTables и OpenTables
для класса data environment.
2.9.2. Свойства класса DataEnvironment
AutoCloseTables - задает закрываются ли таблица или представление,
указанные в объекте data environment, когда объекты form set, form или отчет.
Данное свойство доступно во время разработки, только для чтения при выполнении.
Синтаксис:
DataEnvironment.AutoCloseTables[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
( по умолчанию ) таблица или представление закрываются.
False (.F.)
таблица или представление остаются открытыми.
AutoOpenTables - задает загружаются ли автоматически таблица или
представление, связанные с объектом data environment объектов form set, form или
отчет. Данное свойство доступно во время разработки, только для чтения при
выполнении.
41
Синтаксис:
DataEnvironment.AutoOpenTables[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.) - (по умолчанию)таблица или представление открываются автоматически.
False (.F.) - таблица или представление не открываются автоматически.
InitialSelectedAlias - задает псевдоним, ассоциированный с объектом Cursor
как текущий, когда объект data environment загружается. Данное свойство доступно
во время разработки, только для чтения при выполнении.
Синтаксис:
DataEnvironment.InitialSelectedAlias[ = cText]
cText - указывает имя псевдонима.
OpenViews - определяет тип представления, ассоциированного с объектами
form set, form или report объекта data environment, открывающегося автоматически.
Данное свойство доступно во время разработки, только для чтения при выполнении.
Синтаксис:
DataEnvironment.OpenViews[ = nExpression]
nExpression - имеет следующие допустимые значения:
0 - (по умолчанию) Local and Remote.
- локальные и удаленные
представления открываются автоматически.
1-Local only. - только локальные представления открываются автоматически.
2-Remote only. - только удаленные представления открываются автоматически.
3- None.
- любые представления автоматически не открываются.
Name - указывает имя объекта.
2.9.3. События и методы класса DataEnvironment
AfterCloseTables - возникает после закрытия таблиц и представлений,
указанных в объекте data environment для классов form, form set или отчет.
Синтаксис:
PROCEDURE DataEnvironment.AfterCloseTables
BeforeOpenTables
возникает
перед
закрытием
таблиц
и
представлений,связанных со средой данных формы, набора форм или отчета.
Синтаксис:
PROCEDURE DataEnvironment.BeforeOpenTables
Данные методы класса описаны выше: Destroy
Error
Init
2.10. Класс EditBox
2.10.1. Использование класса EditBox
Данный класс является визуальным и неконтейнером и представляет собой поле
редактирования.. Он применяется для редактирования сивольных переменных,
элементов массивов, полей или полей memo. Все стандартные возможности, такие
как копирование, вставка и перемещение в буфер, для данного класса
поддерживаются.
2.10.2. Свойства класса EditBox
AllowTabs - указывает разрешена ли табуляция в объекте.
Синтаксис:
EditBox.AllowTabs[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
табуляция разрешена, нажмите CTRL+TAB для входа из поля.
False (.F.)
(по умолчанию) табуляция не разрешена, нажатие TAB
перемещает фокус к следующему объекту согласно свойства tab order.
42
MaxLength - задает макимальное количество символов, вводимых в объект
EditBox или TextBox. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Control.MaxLength[ = nMaxLength]
nMaxLength - указывает данное число символов. Если значение данного свойства
установлено в 0, то ограничений для edit box не существует, а для text box
определяется типом данных.
ScrollBars - задает тип полос прокрутки объекта. Данное свойство доступно во
время разработки и только для чтения-записи при выполнении.
Синтаксис:
[Form.]Control.ScrollBars[= nType]
nType - имеет следующие допустимые значения:
0 - None
- отсутствуют
1 - Horizontal
- только горизонтальные
2 - Vertical
- только вертикальные
3 - (по умолчанию)
- горизонтальные и вертикальные
SelectOnEntry - указывает когда текст в объектах column, edit box или text box
выделяется, когда пользователь переходит к объекту. Данное свойство доступно как
во время разработки так и выполнения.
Синтаксис:
Object.SelectOnEntry[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию для column) Текст выделяется.
False (.F.)
(по умолчанию для edit и text box) Текст не выделяется.
Данные свойства класса описаны выше:
Alignment
BackColor
BackStyle
BaseClass
BorderColor
BorderStyle
Class
ClassLibrary
ColorScheme
ColorSource
Comment
ControlSource
DisabledBackColor
DisabledForeColor
DragIcon
DragMode
Enabled
FontBold
FontCondense
FontExtend
FontItalic
FontName
FontOutline
FontShadow
FontSize
FontStrikeThru
FontUnderline ForeColor
Format
Height
HelpContextID HideSelection
Left
Margin
MousePointer
Name
Parent
ParentClass
ReadOnly
RightToLeft
SelectedBackColor
SelectedForeColor
SelLength
SelStart
SelText
SpecialEffect
StatusBarText TabIndex
TabStop
Tag
TerminateRead Text
ToolTipText
Top
Value
Visible
Width
2.10.3. События класса EditBox
Данные события класса описаны выше:
Click
DblClick
Destroy
DragOver
Error
ErrorMessage
Init
InteractiveChange
KeyPress
Message
MiddleClick Event
MouseDown
MouseUp
MouseWheel
ProgrammaticChange
DragDrop
GotFocus
LostFocus
MouseMove
RightClick
43
UIEnable
Valid
When
2.10.3. Методы класса EditBox
Данные методы класса описаны выше:
CloneObject
Drag
Move
ReadMethod
Refresh
ResetToDefault
SetFocus
WriteExpression
WriteMethod
ReadExpression
SaveAsClass
ZOrder
2.11. Класс Form
2.11.1. Использование класса Form
Данный класс является визуальным и контейнером и представляет собой форму
на экране. Он используется как форма, или область на экране, в которую можно
добавить различные объекты. При этом можно задать различные реакции как самой
формы, так и входящих в нее объектов, на пользовательские и системные события,
используя разнообразные методы объекта форма.
2.11.2. Свойства класса Form
ActiveForm - указывает на активную форму в объекте form set или _SCREEN.
Не доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Object.ActiveForm.Property [ = Setting]
или
Object.ActiveForm.Method
Property - указывает имя свойства.
Setting - существующее или новое значение свойства.
Method - указывает имя метода.
Если объект FormSet активен, то свойство ActiveForm указывает на форму,
имеющую фокус.
AlwaysOnTop - предотвращает перекрывание другими формами окна данной
формы. Данное свойство доступно во время разработки и только для чтения-записи
при выполнении.
Синтаксис:
Object.AlwaysOnTop[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
только другие формы со свойством AlwaysOnTop установленным в
true (.T.) могут заслонять данную форму.
False (.F.)
(по умолчанию) форма заслоняется любым окном.
AutoCenter - определяет центрируется ли форма автоматически в главном окне
Visual FoxPro или другом окне. Данное свойство доступно как во время разработки
так и выполнения.
Синтаксис:
Object.AutoCenter [ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
форма центрируется и значения свойств Top и Left изменяются.
False (.F.)
(по умолчанию) форма не центрируется.
BufferMode - указывает как обновляются записи. Данное свойство доступно
как во время разработки так и выполнения.
Синтаксис:
Object.BufferMode[ = nValue]
nValue - имеет следующие допустимые значения:
44
0 (по умолчанию) None. -записи
заблокированны
во
время
начала
редактирования и поля записываются когда указатель перемещается.
1 Pessimistic. -записи заблокированны во время начала редактирования и поля
записываются когда указатель перемещается. Для отмены текущих изменений
используется TABLEREVERT( ).
2 Optimistic. -записи не заблокированны при редактировании и поля
записываются командой TABLEUPDATE( ).
ClipControls - указывает обновляют ли графические методы событий Paint всю
область объекта или только измененную. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Object.ClipControls[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) перерисовывается вся область.
False (.F.)
перерисовывается только измененная область.
Closable - задает свойства для закрытия формы. Данное свойство доступно как
во время разработки так и выполнения.
Синтаксис:
Object.Closable[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) команда меню Close добавляется в меню объекта.
False (.F.)
форма не может быть закрыта, используя меню объекта.
ControlBox - указывает когда появляется меню приложения в левом-верхнем
углу формы или панели инструментов. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Object.ControlBox[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) меню изображается.
False (.F.)
меню не появляется.
CurrentX, CurrentY - задают горизонтальные (X) и вертикальные (Y)
координаты следующего метода перерисовки.
Не доступно во время
програмирования; только для чтения-записи при выполнении.
Синтаксис:
Object.CurrentX[ = nXCoord]
Object.CurrentY[ = nYCoord]
nXCoord, nYCoord - задают горизонтальные (X) и вертикальные (Y) координаты
используя свойство ScaleMode.
DataEnvironment - обеспечивает доступ к объекту data environment.Только для
чтения при выполнении и во время програмирования.
Синтаксис:
Object.DataEnvironment
DataSession - задает когда объекты form, form set или toolbar выполняются в
собственном режиме работы с данными (data session) и имеют различные объекты
data environment. Доступно во время програмирования; только для чтения при
выполнении.
Синтаксис:
Object.DataSession[ = nSession]
nSession - имеет следующие допустимые значения:
1 (по умолчанию)
-режим работы с данными по умолчанию.
2 Private data session.
-для каждого объекта создается свой режим.
45
DataSessionID - возвращает ID номер режима работы с данными конкретных
объектов form set, form или toolbar. Только для чтения во время програмирования и
для чтения-записи при выполнении. Если свойство DataSession данных объектов
установлено в 1 (по умолчанию), то возвращается ID номер данного режима работы
с данными по умолчанию.
Синтаксис:
Object.DataSessionID
Возможно только если свойство DataSession объектов form set, form или toolbar
установлено в 2 (Private data session).
DefOLELCID - указывает значение по умолчанию локального ID номера OLE
для формы или главного окна Visual FoxPro. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Form.DefOLELCID[ = nValue]
nValue - задает данное значение. Оно определяет локальный ID номер для объектов
OLE Bound или OLE Container когда они помещаются на форму или главное окно
Visual FoxPro.
Используйте команду SYS(3005) для вывода локальных ID номеров.
Desktop - определяет положение формы на экране. Доступно во время
програмирования; только для чтения при выполнении.
Синтаксис:
Object.Desktop[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
- форма может располагаться в любом месте экрана Windows.
False (.F.)
(по умолчанию) форма входит в главное окно Visual FoxPro.
Свойство Desktop игнорируется если свойство ShowWindow равно 2 - As TopLevel form.
DrawMode - определяет совместно с цветовыми свойствами изображение линий
и фигур на экране. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Object.DrawMode[ = nMode]
nMode - имеет следующие допустимые значения:
1
Blackness Pen. Фигура рисуется черным.
2
NotMerge Pen. Обратно свойству 15.
3
Mask Not Pen. Комбинация общих свойств для BackColor и инверсии
ForeColor.
4
Not Copy Pen. Обратно свойству 13.
5
Mask Pen Not. Комбинация свойств общих для ForeColor и инверсии
BackColor.
6
Invert. Инверсия BackColor.
7
XOR Pen. Комбинация свойств ForeColor и BackColor, но не вместе.
8
Not Mask Pen. Обратно свойству 9.
9
Mask Pen. Комбинация свойств общих для ForeColor и BackColor.
10
Not XOR Pen. Обратно свойству 7.
11
NOP. No operation. Вывод остается неизменным.
12
Merge Not Pen. Комбинация свойств для BackColor и инверсии
ForeColor.
13
(по умолчанию). Copy Pen. Цвет, определяемый свойством ForeColor.
14
Merge Pen Not. Комбинация свойств ForeColor и инверсии BackColor.
46
15
Merge Pen. Комбинация свойств ForeColor и BackColor.
16
Whiteness Pen. Фигура рисуется белой.
DrawStyle - определяет стиль линии для работы графических методов. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.DrawStyle[ = nStyle]
nStyle - имеет следующие допустимые значения:
0
(Default) Solid. - по умолчанию непрерывная.
1
Dash
- тире.
2
Dot
- точка.
3
Dash-Dot
- точка-тире.
4
Dash-Dot-Dot
- точка-тире-точка.
5
Transparent.
- прозрачная
6
Inside Solid
- внутренняя непрерывная
DrawWidth - определяет ширину линии для вывода из графических методов.
Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.DrawWidth[ = nSize]
nSize - указывает ширину в пикселах (от 1 до 32,767)
FillColor - задает цвет узора заполнения объекта. Данное свойство доступно
как во время разработки так и выполнения.
Синтаксис:
Object.FillColor[ = nColor ]
Object.FillColor[ = RGB(nRedValue, nGreenValue, nBlueValue) ]
nColor - число, определяющее цвет.
nRedValue, nGreenValue, nBlueValue - задают величины красного, зеленого и синего
цвета.
FillStyle - задает узор заполнения объекта. Данное свойство доступно как во
время разработки так и выполнения.
Синтаксис:
Object.FillStyle[ = nStyle]
nStyle - имеет следующие допустимые значения:
0
Solid.
- сплошное заполнение.
1
(по умолчанию) Transparent. - нет заполнения.
2
Horizontal Line. - горизонтальная штриховка.
3
Vertical Line.
- вертикальная штриховка.
4
Upward Diagonal. - штриховка по диагонали слева направо.
5
Downward Diagonal.
- штриховка по диагонали справа налево.
6
Cross.
- горизонтально-вертикальная штриховка.
7
Diagonal Cross. - штриховка по диагонали в обоих направлениях.
HalfHeightCaption - указывает когда заголовок формы имеет половину
нормальной высоты. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Object.HalfHeightCaption[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
Заголовок формы половина нормальной высоты.
False (.F.)
(по умолчанию). Заголовок формы нормальной высоты.
KeyPreview - указывает когда событие формы KeyPress перехватывает событие
KeyPress другого объекта. Данное свойство доступно как во время разработки так и
выполнения.
47
Синтаксис:
Object.KeyPreview[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.) событие KeyPress сначала получает форма, а затем активный объект.
False (.F.) (по умолчанию) событие KeyPress получает только активный объект.
Icon - задает иконку формы.
LockScreen - определяет когда форма выполняет все изменения свойств,
входящих в нее объектов. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Object.LockScreen[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
входящие в форму объекты не отображают изменение своих
свойств.
False (.F.) (по умолчанию) входящие в форму объекты отображают
изменение своих свойств немедленно.
MaxButton - определяет есть ли у формы кнопка максимизации. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Object.MaxButton[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) кнопка есть.
False (.F.)
отсутствует.
MaxHeight, MaxLeft, MaxTop, MaxWidth - задают максимальные значения
размеров свойств формы Height, Left, Top, Width. Данное свойство доступно как во
время разработки так и выполнения.
Синтаксис:
Object.MaxHeight[ = nHeight]
Object.MaxLeft [ = nLeft]
Object.MaxTop[ = nTop]
Object.MaxWidth[ = nWidth]
nHeight, nLeft, nTop, nWidth - максимальные значения соответствующих свойств, в
единицах измерения, указанных в свойстве ScaleMode.
MDIForm - включено для совместимости. используйте свойство ShowWindow.
MinButton - определяет есть ли у формы кнопка минимизации. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис: Object.MinButton[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) кнопка есть.
False (.F.)
отсутствует.
MinHeight, MinWidth - задают минимальные значения размеров свойств
формы Height, Width. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Object.MinHeight[ = nHeight]
Object.MinWidth[ = nWidth]
nHeight, nWidth - минимальные значения соответствующих свойств, в единицах
измерения, указанных в свойстве ScaleMode.
Movable - указывает может ли перемещатся пользователем данный объект по
экрану. Доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Object.Movable[ = lExpr]
48
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) перемещение возможно.
False (.F.)
перемещение возможно. Для column непосредственное их
перемещение невозможно, а можно лишь изменить их порядок.
ReleaseType - возврашает число, определяющее как уничтожается объект Form.
Не доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Object.ReleaseType
ReleaseType - имеет следующие допустимые значения:
0
переменная уничтожается.
1
команда меню или кнопка.
2
выход из Visual FoxPro.
ScaleMode - определяет единицы измерения для координат объекта при
использовании других свойств или методов. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Object.ScaleMode = nMode
nMode - имеет следующие допустимые значения:
0-Foxels - термин Visual FoxPro. Эквивалентны максимальной высоте и средней
ширине символов текущего шрифта.
3-Pixels
- (по умолчанию) наименьшая единица разрешения монитора.
ShowTips - указывает показывать ли всплывающие подсказки для объектов,
входящих в объект Form или ToolBar. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Object.ShowTips = lExpr
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию для ToolBar) подсказки изображаются.
False (.F.)
(по умолчанию для Form) подсказки не изображаются.
ShowWindow - указывает является ли объект form или toolbar дочерней или
верхнего-уровня. Доступно во время програмирования; только для чтения при
выполнении.
Синтаксис:
Form.ShowWindow[ = nExpr]
nExpr - имеет следующие допустимые значения:
0 In Screen (по умолчанию).
- форма дочерняя по отношению к главному
окну Visual FoxPro.
1 In Top-Level Form.
- форма дочерняя по отношению другой форме.
2 As Top-Level Form.
- форма является формой верхнего-уровня.
SizeBox - указывает когда форма имеет в правом нижнем углу элемент
управления размером формы. Доступно во время програмирования; только для
чтения-записи при выполнении.
Синтаксис:
Object.SizeBox = lExpr
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) данный элемент есть.
False (.F.)
данный элемент отсутствует.
WindowType - указывает как ведет себя объект form set или form когда он
запущен с помощью DO FORM. Данное свойство доступно как во время разработки
так и выполнения.
Синтаксис:
Object.WindowType[ = nType]
49
nType - для класса form set имеет следующие допустимые значения:
0-Modeless.
-немодальное.
1-Modal.
-модальное, т.е. ни одна форма не может стать активной а
также меню. Все формы в объекте form set активны.
2-Read.
-форма ведет себя, как если б содержит запустили командой
READ. ( включено только для совместимости).
3-Read Modal.
-аналогично предыдущему, но с особенностью MODAL
(включено также только для совместимости).
nType - для класса form допустимы только значения 0 и 1.
WindowState – определяет вид формы при ее вызове. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
[Object.]WindowState[ = nState]
nState - имеет следующие допустимые значения:
0
Normal – форма имеет размеры, определенные ее свойствами
1
Mini – форма сворачивается в пиктограмму
2
Max – форма распахивается на весь экран
ZoomBox - указывает когда форма имеет кнопку дляизменения размеров в
верхнем правом углу. Доступно во время програмирования; только для чтениязаписи при выполнении.
Синтаксис:
Object.ZoomBox = lExpr
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) кнопка есть.
False (.F.)
отсутствует.
Данные свойства класса описаны выше:
ActiveControl
BackColor
BaseClass
BorderStyle
Caption
Class
ClassLibrary
ColorSource
Comment
ControlCount
Controls
Enabled
FontBold
FontCondense
FontExtend
FontItalic
FontName
FontOutline
FontShadow
FontSize
FontStrikeThru
FontUnderline ForeColor
Height
HelpContextID
Left
MousePointer
Name
Parent
ParentClass
Picture
RightToLeft
TabIndex
TabStop
Tag
Top
Visible
Width
2.11.3. События класса Form
Activate - имеет место, когда становится активным объект FormSet, Form или
Page или при отображении объекта ToolBar.
Синтаксис:
PROCEDURE Object.Activate
Deactivate - когда деактивизируется объект типа контейнер(например форма),
т.е. ни один, входящий в него объект не имеет фокус. Для toolbar происходит когда
данный объект скрывется, используя метод Hide.
Синтаксис:
PROCEDURE Object.Deactivate
Load - имеет место непосредственно перед созданием объекта.
Синтаксис:
PROCEDURE Object.Load
[LPARAMETERS nIndex]
50
nIndex - уникальный идентификатор объекта, если он входит в множество объектов
.
Paint - имеет место при перерисовывании формы или панели инструментов.
Синтаксис:
PROCEDURE Object.Paint
QueryUnload - имеет место перед выгрузкой объекта Form.
Синтаксис:
PROCEDURE Form.QueryUnload
Unload - имеет место при уничтожении объекта.
Синтаксис:
PROCEDURE Object.Unload
[LPARAMETERS nIndex]
nIndex - данный параметр описан выше.
Например при удалении объекта form set, содержащего одну форму, а в ней
класс CommandButton происходят следующие события:
1. Событие Destroy объекта FormSet
2. Событие Destroy объекта Form
3. Событие Destroy объекта CommandButton
4. Событие Unload объекта Form
5. Событие Unload объекта FormSet
Данные события класса описаны выше:
Click
DblClick
Destroy
DragDrop
DragOver
Error GotFocus Init
KeyPress
LostFocus
MiddleClick
MouseDown
MouseMove
MouseUp
MouseWheel
Moved
Resize
RightClick
2.11.4. Методы класса Form
Box - рисует прямоугольник в форме.
Синтаксис:
Object.Box(nXCoord1, nYCoord1, nXCoord2, nYCoord2)
или Object.Box(nXCoord2, nYCoord2)
nXCoord1, nYCoord1, nXCoord2, nYCoord2 - координаты начала и конца
соответственно. Если nXCoord1, nYCoord1 отсутствуют, то используются значения
свойств CurrentX и CurrentY.
Circle - рисует окружность или эллипс в форме.
Синтаксис:
Object.Circle (nRadius [, nXCoord, nYCoord [, nAspect]])
nRadius - указывает радиус.
nXCoord, nYCoord - указывает координаты центра.
nAspect - указывает отношение (для построения эллипса не равно единице).
Cls - удаляет графику и текст из формы.
Синтаксис:
Object.Cls
Значения свойств CurrentX и CurrentY устанавливаются в 0
Draw - рисует форму.
Синтаксис:
Object.Draw
Hide - скрывает объект Form, FоrmSet или ToolBar, присваивая его свойству
Visible значение (.F.).
Синтаксис:
Object.Hide
Line - рисует линию в форме.
Синтаксис:
Object.Line(nXCoord2, nYCoord2)
или
Object.Line(nXCoord1, nYCoord1, nXCoord2, nYCoord2)
51
nXCoord1, nYCoord1, nXCoord2, nYCoord2 - данные параметры описаны
выше.
Point - возвращает цвет в модели RGB(красный, зеленый, синий) для заданной
точки формы.
Синтаксис:
Object.Point ([nXCoord, nYCoord])
nXCoord, nYCoord - задает вертикальные и горизонтальные координаты точки.
Print - печататет символьную строку в объекте Form.
Синтаксис:
[FormSet.] Object.Print [(cText)]
cText - указывает строку символов.
Pset - устанавливает для точки формы или основного окна VisualFoxPro
основной цвет символов.
Синтаксис:
[FormSet.]Object.PSet([nXCoord, nYCoord])
nXCoord, nYCoord - данные параметры описаны выше.
Release - освобождает объект Form или FormSet из памяти.
Синтаксис:
Object.Release
Show - отображает объект Form и определяет его тип - модальный или
немодальный.
Синтаксис:
[FormSet.]Object.Show([nStyle])
nStyle - имеет следующие допустимые значения:
1-Modeless.
-немодальное.
2-Modal.(по умолчанию)
-модальное, т.е. ни одна форма не может стать
активной а также меню. Все формы в объекте form set активны.
TextHeight - возвращает высоту текстовой строки, используя единицу
измерения, устанавливаемую свойством ScaleMode объекта Form.
Синтаксис:
[nHeight =] [FormSet.]Object.TextHeight(cText)
nHeight - возвращает высоту в пикселах.
cText - определяет данную строку.
TextWidth возвращает ширину текстовой строки, используя единицу
измерения, устанавливаемую свойством ScaleMode объекта Form.
Синтаксис:
[nWidth =] [FormSet.]Object.TextWidth(cText)
nWidth - возвращает ширину в пикселах.
cText - определяет данную строку.
Данные методы класса описаны выше:
AddObject
Move
ReadExpression
ReadMethod
Refresh
RemoveObject
ResetToDefault
SaveAs
SaveAsClass
SetAll
WriteExpression
WriteMethod
ZOrder
2.12. Класс FormSet
2.12.1. Использование класса FormSet
Данный класс является невизуальным и контейнером и представляет собой
группу форм, над которыми можно выполнять различные действия и изменять
свойства как по-отдельности, так и для всех вместе.
2.12.2. Свойства класса FormSet
52
AutoRelease - указывает уничтожается ли объект form set при уничтожении
последней формы данного класса. Доступно во время програмирования; только для
чтения-записи при выполнении.
Синтаксис:
FormSet.AutoRelease[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию в Form Designer). объект form set уничтожается.
False (.F.) (по умолчанию при программировании). объект form set не уничтожается.
FormCount - содержит значение количества форм в объекте form set. Не
доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Object.FormCount
Forms - массив, реализующий доступ к каждой форме объекта form set. Не
доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Object.Forms( nIndex)
nIndex - уникальный идентификатор объектов form для объекта form set.
ReadBackColor, ReadForeColor, ReadCycle, ReadLock, ReadMouse, ReadSave,
ReadTimeOut, WindowList - данные свойства включены для совместимости с
READ. Вместо них используйте Form Designer.
Данные свойства класса описаны выше:
ActiveForm
Buffermode
BaseClass
Class
ClassLibrary
Comment
DataEnvironment
DataSession
DataSessionID
Name
ParentClass
Visible
WindowType
2.12.3. События класса FormSet
ReadActivate, ReadDeactivate, ReadShow, ReadValid, ReadWhen - данные
события включены для совместимости с READ. Вместо них используйте Form
Designer.
Данные события класса описаны выше:
Activate
Deactivate
Destroy
Error
Init
Load
Unload
2.12.4. Методы класса FormSet
Данные методы класса описаны выше:
AddObject
Hide
Init
ReadMethod
Refresh
Release
ResetToDefault
SaveAs
SaveAsClass
Show
WriteExpression
ReadExpression
RemoveObject
SetAll
WriteMethod
2.13. Класс Grid
2.13.1. Использование класса Grid
Данный класс является визуальным и контейнером и представляет собой
таблицу. Он изображает информацию используя колонки, которые являются классом
column, входящим в данный объект-контейнер, и строки. Также в данный класс
входит объект Header, представляющий собой заголовок колонки. Таким образом
появляется возможность управлять всеми элементами класса Grid.
2.13.2. Свойства класса Grid
53
ActiveColumn - возвращает колонку, содержащую активную ячейку объекта
Grid. Не доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Grid.ActiveColumn
ActiveRow - указывает строку, содержащую активную ячейку объекта Grid. Не
доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Grid.ActiveRow
ChildOrder - задает имя индекса, используемого для установки связи между
таблицами. Доступно во время програмирования; только для чтения при
выполнении.
Синтаксис:
Object.ChildOrder[ = cTagName]
cTagName - определяет существующее имя индексного тэга.
Если свойство ChildOrder установлено, свойство Order объекта Cursor для
данной таблицы игнорируется.
Columns - массив, с помощью которого организуется доступ к каждому объекту
Column, входящих в класс Grid, согласно номеров column. Доступно во время
програмирования; только для чтения при выполнении.
Синтаксис:
Grid.Columns(nCol).Property [ = Setting]
nCol - номер колонки ( первая слева колонка имеет номер один).
Property - какое-либо свойство объекта Column.
Setting - какое-либо значение свойства.
DeleteMark - задает изображать или нет помеченные на удаление объекты
column,входящие в Grid. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Grid.DeleteMark[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) данные колонки изображаются слева.
False (.F.)
данные колонки не выводятся.
GridLineColor - определяет
цвет сетки таблицы. Доступно во время
програмирования; только для чтения-записи при выполнении.
Синтаксис:
Grid.GridLineColor[ = nColor]
или
Grid.GridLineColor = RGB(nRedValue, nGreenValue, nBlueValue)
nColor – указывает число, определяющее цвет.
nRedValue, nGreenValue, nBlueValue – определяют три различных цветовых
параметра, определяющих конечный цвет.
GridLines - определяет стиль таблицы. Доступно во время програмирования;
только для записи-чтения при выполнении.
Синтаксис:
Grid.GridLines[ = nSetting]
nSetting - имеет следующие допустимые значения:
0-None
- в таблице отсутствуют и горизонтальные и вертикальные линии.
1-Horizontal
- в таблице присутствуют только горизонтальные линии.
2-Vertical
- в таблице присутствуют только вертикальные линии.
3-Both(по умолчанию)
- в таблице присутствуют и горизонтальные и
вертикальные линии.
GridLineWidth - задает толщину сетки таблицы. Доступно во время
програмирования; только для записи-чтения при выполнении.
Синтаксис:
Grid.GridLineWidth[ = nWidth]
54
nWidth - задает толщину линий.
HeaderHeight - задает высоту заголовка колонки для объекта Grid. Доступно во
время програмирования; только для записи-чтения при выполнении.
Синтаксис:
Header.HeaderHeight[ = nHeight]
nHeight - значение высоты в пикселах.
HighLight - задает выделяется ли ячейка объекта Grid, имеющая фокус.
Доступно во время програмирования; только для записи-чтения при выполнении.
Синтаксис:
Grid.Highlight[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) ячейка выделяется.
False (.F.)
ячейка не выделяется.
HighLightRow - задает выделяется ли текущая ячейка и строка объекта Grid.
Доступно во время програмирования; только для записи-чтения при выполнении.
Синтаксис:
Grid.HighlightRow[ = lExpr]
lExpr - имеет следующие допустимые значения:
The settings for the HighlightRow property are:
True (.T.)
(по умолчанию) ячейка и строка выделяются.
False (.F.)
ячейка и строка не выделяются.
LeftColumn - содержит номер крайней слева колонки, изображаемой в объекте
Grid control.Только для чтения во время програмирования и при выполнении.
Синтаксис:
Grid.LeftColumn
Например если LeftColumn = 3, то колонки 1 и 2 не видимы.
LinkMaster - определяет родительскую таблицу, связанную с дочерней,
изображенной в объекте Grid. Доступно во время програмирования; только для
записи-чтения при выполнении.
Синтаксис:
Grid.LinkMaster[ = cName]
cName - указывает псевдоним родительской таблицы.
PanelLink - определяет связаны ли правая и левая части объекта Grid, когда
данный объект разделен на две части. Доступно если свойство Partition больше 0.
Доступно во время програмирования; только для записи-чтения при выполнении.
Синтаксис:
Grid.PanelLink[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) левая и правая половины связаны.
False (.F.)
левая и правая половины не связаны.
Panel - указывает активную панель в объекте Grid. Доступно если свойство
Partition больше 0. Доступно во время програмирования; только для записи-чтения
при выполнении.
Синтаксис:
Grid.Panel[ = nSide]
nSide - имеет следующие допустимые значения:
0
- активна левая панель.
1
(по умолчанию) - активна правая панель.
Partition - определяет когда объект Grid разделен на две панели и указывает
место этошо разрыва. Доступно во время програмирования; только для записичтения при выполнении.
Синтаксис:
Grid.Partition[ = nSplit]
nSplit - указывает позицию разрыва на две части (если 0 то разрва нет ).
55
RecordMark - определяет наличие с левой стороны объекта Grid столбца,
содержащего указатель текущей записи. Доступно во время програмирования;
только для записи-чтения при выполнении.
Синтаксис:
Grid.RecordMark[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) столбец присутствует.
False (.F.)
столбец отсутствует.
RecordSourceType - задает тип источника данных. Доступно во время
програмирования; только для записи-чтения при выполнении.
Синтаксис:
Grid.RecordSourceType[ = nType]
nType - имеет следующие допустимые значения:
0-Table
-автоматически открывает таблицу, заданную свойством
RecordSource.
1-(по умолчанию) Alias
-использует заданный псевдоним таблицы.
2-Prompt
-если для формы не определены таблицы в окне окружения,
запрашивается исходная таблица для отображения в объекте Grid.
3-Query (.QPR) -в качестве источника данных используются результаты запроса.
4-SQL Statement. -в качестве источника данных используется SQL предложение.
RelationalExpr - определяет выражение, содержащее поля родительской
таблицы, связывающее с помощью индекса дочерней таблицы эти таблицы. Для
объекта Grid это свойство доступно во время програмирования; только для записичтения при выполнении. Для объекта Relation это свойство доступно во время
програмирования; только для чтения при выполнении.
Синтаксис:
Object.RelationalExpr[ = cExpr]
cExpr - определяет данное выражение.
RelativeColumn - указывает активную колонку в видимой части объекта. Не
доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Grid.RelativeColumn[ = nColumn]
nColumn - определяет номер колонки.
RelativeRow - указывает активная строки в видимой части объекта. Не
доступно во время програмирования; только для чтения при выполнении.
Синтаксис:
Grid.RelativeRow[ = nRow]
nRow - определяет номер строки.
RowHeight - задает высоту строки таблицы. Доступно во время
програмирования; только для записи-чтения при выполнении.
Синтаксис:
Grid.RowHeight[ = nHeight]
nHeight - указывает высоту строки.
Если свойство RowHeight установлено в – 1 (Auto) то высота строки
определяется значением свойства FontSize.
View - указывает тип просмотра объекта Grid. Доступно во время
програмирования; только для записи-чтения при выполнении.
Синтаксис:
Grid.View[ = nType]
nType - имеет следующие допустимые значения (если колонки не разделены, т.е.
свойство Partition установлено в 0 ):
0
Browse
1
Change
56
Если колонки разделены, то nType имеет следующие допустимые значения:
0
Browse (левая панель), Browse (правая панель)
1
Browse (левая панель), Change (правая панель)
2
Change (левая панель), Browse (правая панель)
3
Change (левая панель), Change (правая панель)
Данные свойства класса описаны выше:
BackColor
BaseClass
Class
ClassLibrary
ColumnCount
Comment
DragIcon
DragMode
Enabled
FontBold
FontCondense
FontExtend
FontItalic
FontName
FontOutline
FontShadow
FontSize
FontStrikeThru
FontUnderline ForeColor
Height
HelpContextID
Left
MousePointer
Name
Parent
ParentClass
ReadOnly
RightToLeft
ScrollBars
StatusBarText TabIndex
TabStop
Tag
ToolTipText
Top
Value
Visible
Width
2.13.3. События класса Grid
AfterRowColChange - при переходе в другую строку или другой столбец
объекта Grid.
Синтаксис:
PROCEDURE Grid.AfterRowColChange
LPARAMETERS nColIndex
nColIndex - возвращает индекс выбранной колонки и строки.
BeforeRowColChange - имеет место перед тем, как пользователь изменяет
активную строку или столбец объекта Grid.
Синтаксис:
PROCEDURE Grid.BeforeRowColChange
LPARAMETERS nColIndex
nColIndex - возвращает индекс выбранной колонки и строки.
Deleted - имеет место когда пользователь удаляет пометку записи на удаление
или когда вызывается команда DELETE.
Синтаксис:
PROCEDURE Grid.Deleted
LPARAMETERS nRecNo
nRecNo - возвращает номер строки удаляемой записи.
Scrolled - происходит при прокрутке данных в объекте управления Grid.
Синтаксис:
PROCEDURE Grid.Scrolled
LPARAMETERS [nIndex], nDirection
nIndex - уникальный идентификатор объекта, если он входит в множество объектов .
nDirection указывает действие пользователя и имеет следующие значения:
0
-используется клавиша вверх
1
-используется клавиша ввниз
2
- используется нажатие верхней части полосы вертикальной прокрутки
3
- используется нажатие нижней части полосы вертикальной прокрутки
4
-используется клавиша влево
5
-используется клавиша вправо
6
- используется нажатие левой части полосы горизонтальной прокрутки
7
- используется нажатие правой части полосы горизонтальной прокрутки
57
Данные события класса описаны выше:
Click
DblClick
Destroy
Error
Init
MiddleClick
MouseUp MouseWheel
Resize
UIEnable Valid
When
DragDrop
MouseDown
RightClick
DragOver
MouseMove
Moved
2.13.4. Методы класса Grid
ActivateCell - активизирует ячейку в элементе управления Grid.
Синтаксис:
Grid.ActivateCell(nRow, nCol)
nRow, nCol - определяет строку и колонку ячейки.
AddColumn - добавляет объект Column в элемент управления Grid.
Синтаксис:
Grid.AddColumn(nIndex)
nIndex - определяет номер позиции новой колонки
Например, для добавления новой колонки и задания содержит имени:
THISFORM.Grid1.AddColumn(1)
THISFORM.Grid1.Columns(THISFORM.Grid1.ColumnCount).Name = "Новая колонка"
THISFORM.Grid1.NewColumn.ControlSource = "Customer.CustID"
DeleteColumn - удаляет объект Column из элемента управления Grid.
Синтаксис:
Grid.DeleteColumn[(nIndex)]
nIndex - определяет номер позиции колонки (по умолчанию последняя).
DoScroll - моделирует работу пользователя с полосами прокрутки в объекте
Grid.
Синтаксис:
Grid.DoScroll(nDirection)
nDirection - имеет следующие допустимые значения:
0
-прокрутка вверх
1
-прокрутка вниз
2
-прокрутка страницы вверх
3
-прокрутка страницы вниз
4
-прокрутка влево
5
-прокрутка вправо
6
-прокрутка страницы влево
7
-прокрутка страницы вправо
Данные методы класса описаны выше:
AddObject
CloneObject
Drag
Move
ReadExpression
ReadMethod
Refresh
RemoveObject
ResetToDefault
SaveAsClass
SetAll
SetFocus
WriteExpression
WriteMethod
ZOrder
2.14. Класс Column
2.14.1. Использование класса Column
Данный класс является визуальным и контейнером и представляет собой
столбец таблицы, который входит в класс Grid. Источником данных для этого класса
являются поля таблицы или значение выражения.
Заголовки и объекты данного класса Column не доступны, пока не произойдет
событие Init объекта Grid, в который входит данный класс.
58
2.14.2. Свойства класса Column
Bound - определяет является источником данных для объектов, входящих в
объект Column, данный объект Column. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Column.Bound[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) источником данных является объект column.
False (.F.)
у каждого объекта свой источник данных.
Классы, которые могут входить в Column
Типы данных
CheckBox
Logical, Numeric
ComboBox
Character, Numeric
CommandButton
Character, Numeric
EditBox
Character
ListBox
Character, Numeric
OptionButton
Character, Numeric
Spinner
Currency, Numeric
TextBox
Любые данные кроме General или Memo
ColumnOrder - определяет порядковый номер столбца в таблице.
Синтаксис:
Column.ColumnOrder[ = nExpr]
nExpr - определяет данный номер
CurrentControl - указывает какой объект, входящий в объект Column,
используется для отображения содержимого активной ячейки. Не доступно во время
програмирования; только для чтения-записи при выполнении.
Синтаксис:
Column.CurrentControl[ = cName]
cName - содержит имя объекта.
DynamicAlignment,
DynamicBackColor,
DynamicCurrentControl,
DynamicFontBold, DynamicFontItalic, DynamicFontName, DynamicFontOutline,
DynamicFontShadow,
DynamicFontSize,
DynamicFontStrikeThru,
DynamicFontUnderline, DynamicForeColor, DynamicInputMask - данные свойства
аналогичны свойствам Alignment, BackColor, CurrentControl, FontBold, FontCondense,
FontExtend, FontItalic, FontName, FontOutline, FontShadow, FontSize, FontStrikeThru,
FontUnderline, ForeColor, InputMask но их значение обновляется каждый раз при
обновлении объекта Grid. Доступно во время програмирования; только для чтениязаписи при выполнении.
Синтаксис:
Column.DynamicAlignment[ = cAlign]
Column.DynamicBackColor[ = cExpression]
Column.DynamicFontName[ = cName]
и т.д.
cAlign, cExpression, cName и т.д. - данные параметры прелставляют собой
символьные выражения, которые пересчитываются каждый раз при обновлении
объекта Grid и их результирующее значение должно соответствовать типу значения
для каждого конкретного свойства ( например для DynamicBackColor - число,
определяющее цвет, для DynamicFontName - имя шрифта, и т.п.).
Resizable - определяет может ли объект Column изменять свои размеры.
Доступно во время програмирования; только для чтения-записи при выполнении.
59
Синтаксис:
Column.Resizable[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
размеры могут изменятся.
False (.F.)
(по умолчанию) размеры постоянны.
Sparse - указывает определяет свойство CurrentControl все ячейки или только
активные для объекта Column. Доступно во время програмирования; только для
чтения-записи при выполнении.
Синтаксис:
Column.Sparse [= lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
(по умолчанию) только активная ячейка использует значение
свойства CurrentControl для отображения данных.
False (.F.)
все ячейки используют значение свойства CurrentControl для
отображения данных.
Данные свойства класса описаны выше:
Alignment
BackColor
BaseClass
Class
ClassLibrary
ControlCount
Controls
ControlSource Enabled
FontBold
FontCondense
FontExtend
FontItalic
FontName
FontOutline
FontShadow
FontSize
FontStrikeThru FontUnderline ForeColor
Format
InputMask
Movable
Name
Parent
ParentClass
ReadOnly
SelectOnEntry Visible
Width
2.14.3. События класса Column
Данные события класса описаны выше:
MouseMove
MouseWheel
Moved
Resize
2.14.4. Методы класса Column
Данные методы класса описаны выше:
AddObject
Move
ReadExpression ReadMethod
RemoveObject ResetToDefault SetAll
SetFocus
WriteExpression
WriteMethod
Zorder
Refresh
2.15. Класс Header
2.15.1. Использование класса Header
Данный класс является визуальным и неконтейнером и представляет собой
заголовок столбцов таблицы. Каждая колонка в объекте grid содержит заголовок, для
которого могут задаваться свойства и происходить события.
2.15.2. Свойства класса Header
Данные свойства класса описаны выше:
Alignment
BackColor
BaseClass
ClassLibrary
FontBold
FontCondense
FontName
FontOutline
FontShadow
FontUnderline ForeColor
Name
2.15.3. События класса Header
Caption
Class
FontExtend
FontItalic
FontSize FontStrikeThru
Parent
ParentClass
60
Данные события класса описаны выше:
Click
DblClick
MiddleClick
MouseMove
MouseUp
MouseWheel
2.15.4. Методы класса Header
Данные методы класса описаны выше:
ReadExpression
ReadMethod
ResetToDefault
WriteExpression
MouseDown
RightClick
Refresh
WriteMethod
2.16. Класс Image
2.16.1. Использование класса Image
Данный класс является визуальным и неконтейнером и представляет собой
некое изображение. Для него могут установливаться различные свойства и события.
2.16.2. Свойства класса Image
Stretch – задает способ отображения картинки. Данное свойство доступно как
во время разработки так и выполнения.
Синтаксис:
[Form.]Control.Stretch[= nType]
nType - имеет следующие допустимые значения:
0 – Clip(по умолчанию) - происходит усечение картинки для уменьшения ее
размера.При этом всегда отсекается правая и нижняя сторона рисунка, а сам рисунок
распологается в форме начиная с левого верхнего угла.
1 – Isometric
рисунок
будет
растянут
с
сохранением
пропорций(отношения ширины к высоте).
2- Stretch
- рисунок будет растянут без сохранения пропорций
Данные свойства класса описаны выше:
BackStyle
BaseClass
BorderColor
BorderStyle
Class
ClassLibrary
ColorSource
Comment
DragIcon
DragMode
Enabled
Height
HelpContextID Left
MousePointer
Name
Parent
ParentClass
Picture
Tag
Top
Visible
Width
2.16.3. События класса Image
Данные события класса описаны выше:
Click
DblClick
Destroy
Error
Init
MiddleClick
MouseUp MouseWheel
RightClick
DragDrop
MouseDown
UIEnable
2.16.4. Методы класса Image
Данные методы класса описаны выше:
CloneObject
Drag Move
ReadExpression
ResetToDefault
SaveAsClass
WriteExpression
DragOver
MouseMove
Zorder
ReadMethod
WriteMethod
61
2.17. Класс Label
2.17.1. Использование класса Label
Данный класс является визуальным и неконтейнером и представляет собой
надпись. Для нее задаются различные свойства и события. Для определения кнопки
доступа необходимо поместить знак (\<) перед данным символом в свойстве caption.
2.17.2. Свойства класса Label
Данные свойства класса описаны выше:
Alignment
AutoSize
BaseClass
BorderStyle
ClassLibrary
ColorScheme
DisabledBackColor
DisabledForeColor
Enabled
FontBold
FontOutline
FontShadow
FontUnderline
ForeColor
Left
MousePointer
ParentClass
RightToLeft
Top
Visible
BackColor
Caption
ColorSource
DragIcon
FontItalic
FontSize
Height
Name
TabIndex
Width
2.17.3. События класса Label
Данные события класса описаны выше:
Click
DblClick
Destroy
Error
Init
MiddleClick
MouseUp
MouseWheel
RightClick
BackStyle
Class
Comment
DragMode
FontName
FontStrikeThru
HelpContextID
Parent
Tag
WordWrap
DragDrop
MouseDown
UIEnable
2.17.4. Методы класса Label
Данные методы класса описаны выше:
CloneObject
Drag
Move
ReadMethod
ResetToDefault SaveAsClass
WriteExpression
WriteMethod
ZOrder
DragOver
MouseMove
ReadExpression
UIEnable
2.18. Класс Line
2.18.1. Использование класса Line
Данный класс является визуальным и неконтейнером и представляет собой
линию. Она может иметь различные свойства, начертание, события и широко
используется в объектах форма и других .
2.18.2. Свойства класса Line
LineSlant - указывает какой уклон имеет линия. Данное свойство доступно как
во время разработки так и выполнения.
Синтаксис:
Line.LineSlant[ = cSlant]
cSlant - имеет следующие допустимые значения:
\ (по умолчанию) - линия идет из верхнего-левого в правый-нижний угол.
/
- линия идет из левого-нижнего в правый-верхний угол.
62
Данные свойства класса описаны выше:
BaseClass
BorderColor
BorderStyle
Class
ClassLibrary
ColorSource
DragIcon
DragMode
DrawMode
Height
HelpContextID
Left
Name
Parent
ParentClass
Top
Visible
Width
BorderWidth
Comment
Enabled
MousePointer
Tag
2.18.3. События класса Line
Данные события класса описаны выше:
Click
DblClick
Destroy
Init
MiddleClick
MouseDown
MouseWheel
RightClick
DragDrop
MouseMove
UIEnable
2.18.4. Методы класса Line
Данные методы класса описаны выше:
CloneObject
Drag
Move
ResetToDefault
SaveAsClass
WriteMethod
ReadExpression
ReadMethod
WriteExpression
ZOrder
DragOver Error
MouseUp
2.19. Класс ListBox
2.19.1. Использование класса ListBox
Данный класс является визуальным и неконтейнером и представляет собой
список. Для данногго списка есть возможнось выбора нескольких элементов,
добавления новых и изменения остающихся. Класс list box подобен классу combo
box, но имеет разное графическое представление.
2.19.2. Свойства класса ListBox
MoverBars - указывает есть ли у объекта ListBox кнопки перемещения.
Доступно во время програмирования; только для чтения-записи при выполнении.
Синтаксис:
ListBox.MoverBars[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
- кнопки присутствуют.(можно изменить порядок содержимого).
False (.F.)
(по умолчанию) кнопки отсутствуют.
Данное свойство доступно только если свойство RowSourceType установлено в
0 (None) или 1 (Value).
Данные свойства класса описаны выше:
BaseClass
BorderColor
BoundColumn
BoundTo
Class
ClassLibrary
ColorScheme
ColorSource
ColumnCount
ColumnLines
ColumnWidths
Comment
ControlSource DisabledBackColor
DisabledForeColor
DisplayValue
DisabledItemBackColor
DisabledItemForeColor
DragIcon
DragMode
Enabled
FirstElement
FontBold
FontCondense
FontExtend
FontItalic
FontName
FontOutline
FontShadow
FontSize
FontStrikeThru
FontUnderLine Height
HelpContextID
IncrementalSearch
63
ItemBackColor ItemData
ItemForeColor
ItemIDData
ItemTips
Left
List
ListCount
ListIndex
ListItem
ListItemID
MousePointer
MultiSelect
Name
NewIndex
NewItemID
NumberOfElements
Parent
ParentClass
RightToLeft
RowSource
RowSourceType
Selected
SelectedID
SelectedItemBackColor
Width
SelectedItemForeColor
Sorted
SpecialEffect
StatusBarText
TabIndex
TabStop
Tag
TerminateRead
ToolTipText
Top
TopIndex
TopItemID
Value
Visible
2.19.3. События класса ListBox
Данные события класса описаны выше:
Click
DblClick
Destroy
Error
ErrorMessage
GotFocus
KeyPress
LostFocus
Message
MouseMove
MouseUp
MouseWheel
RangeHigh
RangeLow
RightClick
2.19.4. Методы класса ListBox
Данные методы класса описаны выше:
AddItem
AddListItem
Clear
IndexToItemID ItemIDToIndex Move
Refresh
RemoveItem
Requery
SaveAsClass
SetFocus
When
DragDrop
DragOver
Init
InteractiveChange
MiddleClick
MouseDown
ProgrammaticChange
UIEnable
Valid
CloneObject
ReadExpression
RemoveListItem
WriteExpression
ZOrder
Drag
ReadMethod
ResetToDefault
WriteMethod
2.20. Класс OLEControl
2.20.1. Использование класса OLEControl
Данный класс представляет собой OLE-объект управления. Он позволяет
добавлять в приложения OLE объекты. OLE объекты разделяют на объекты ActiveX
(файлы .OCX) и выделенные OLE объекты, созданные в других приложениях, таких
как Microsoft Word и Microsoft Excel. В отличие от объектов ActiveX (файлы .OCX),
выделенные объекты не имеют своих собственных событий. Объекты OLEcontainer в
отличии от объектов OLEbound не основываются на полях General таблиц Visual
FoxPro. Некоторые свойства, события и методы данного класса не будут описанны,
из-за его узкого и редкого использования данного класса.
2.20.2. Свойства класса OLEControl
AutoActivate
AutoVerbMenu DocumentFile
HostName Object
OLEClass
OLELCID
OLETypeAllowed
Данные свойства класса описаны выше:
Align
AutoSize
BaseClass
Cancel
Class
ClassLibrary
Comment ControlSource Default
DragIcon DragMode Enabled
Height
HelpContextID MouseIcon
Left
Name
Parent
Sizable
MousePointer
ParentClass
Stretch
TabIndex TabStop
64
Tag
WhatsThisHelpID
Top
Visible
2.20.3. События класса OLEControl
Данные события класса описаны выше:
Destroy
DragDrop
DragOver Error
LostFocus
Moved
Resize
UIEnable
Width
GotFocus
2.20.4. Методы класса OLEControl
DoVerb - выполняет глагол для заданного OLE-объекта.
Данные методы класса описаны выше:
CloneObject
Drag
Move
Refresh
SaveAsClass
SetFocus ShowWhatsThis
ZOrder
Init
ResetToDefault
2.21. Класс OLEBoundControl
2.21.1. Использование класса OLEBoundControl
Данный класс представляет собой OLE-объект данных. В объекте form или
отчете класс OLE bound позволяет изображать содержимое OLE объекта (например
объекта из Microsoft Word или Microsoft Excel) в поле General таблицы. В отличие от
объектов OLE container, выделенные объекты не имеют своих собственных событий.
Некоторые свойства, события и методы данного класса не будут описанны, из-за его
узкого и редкого использования данного класса.
2.21.2. Свойства класса OLEBoundControl
AutoActivate
DocumentFile
HostName
OLEClass
OLELCID
OLETypeAllowed
Данные свойства класса описаны выше:
AutoSize BaseClass ClassLibrary
Class
Comment
DragIcon DragMode HelpContextId Enabled
Height
Left
Name
ParentClass
Sizable
Stretch
TabStop Tag
Top
Value
Visible
Object
ControlSource
MousePointer
TabIndex
Width
2.21.3. События класса OLEBoundControl
Данные события класса описаны выше:
Destroy
DragDrop Init
DragOver Error
GotFocus LostFocus Moved
Resize
UIEnable
2.21.4. Методы класса OLEBoundControl
Данные методы класса описаны выше:
CloneObject
DoVerb
Drag
ResetToDefault SaveAsClass
SetFocus
Move
ZOrder
Refresh
65
2.22. Класс OptionButton
2.22.1. Использование класса OptionButton
Данный класс является визуальным и неконтейнером и представляет собой
переключатель.Этот класс широко используется для задания значений величин,
имеющих два противоположных значения.
2.22.2. Свойства класса OptionButton
Данные свойства класса описаны выше:
Alignment
AutoSize
BackColor
BackStyle
BaseClass
Caption
Class
ClassLibrary
ColorScheme
ColorSource
Comment
ControlSource DisabledBackColor
DisabledForeColor
DisabledPicture DownPicture
DragIcon
DragMode
Enabled
FontBold
FontCondense
FontExtend
FontItalic
FontName
FontOutline
FontShadow
FontSize
FontStrikeThru
FontUnderLine
ForeColor
Height
HelpContextID Left
MousePointer
Name
Parent
ParentClass
Picture
RightToLeft
SpecialEffect
StatusBarText Style
TabIndex
TabStop
Tag
TerminateRead ToolTipText
Top
Visible
Width
2.22.3. События класса OptionButton
Данные события класса описаны выше:
Click
DblClick Destroy
DragDrop
ErrorMessage
GotFocus Init
KeyPress
MiddleClick
MouseDown
MouseMove
MouseWheel
RightClick
Valid
2.22.4. Методы класса OptionButton
Данные методы класса описаны выше:
CloneObject
Drag Move
Refresh
ResetToDefault
WriteExpression
WriteMethod
DragOver
LostFocus
MouseUp
When
ReadExpression
SaveAsClass
ZOrder
Error
Message
ReadMethod
SetFocus
2.23. Класс OptionGroup
2.23.1. Использование класса OptionGroup
Данный класс является визуальным и контейнером и представляет собой набор
переключателей. Он позволяет управлять свойствами и событиями переключателей,
входящих в него, как по-отдельности,так и вместе и используется для
предоставления пользователю возможности выбора какого-то одного значения из
нескольких предложенных.
2.23.2. Свойства класса OptionGroup
Данные свойства класса описаны выше:
AutoSize
BackColor
BackStyle
BorderStyle
ButtonCount
Buttons
BaseClass
Class
BorderColor
ClassLibrary
66
Comment
Enabled
MousePointer
Tag
ColorSource
Height
Parent
TerminateRead
ControlSource DragIcon
HelpContextID Left
ParentClass
SpecialEffect
Top
Value
Visible
2.23.3. События класса OptionGroup
Данные события класса описаны выше:
Click
DblClick
DragDrop
ErrorMessage
InteractiveChange
Message
MouseDown
MouseMove
MouseUp
ProgrammaticChange
RightClick
DragMode
Name
TabIndex
Width
DragOver
MiddleClick
MouseWheel
UIEnable
2.23.4. Методы класса OptionGroup
Данные методы класса описаны выше:
AddObject
CloneObject
Drag
Move
ReadMethod
Refresh
RemoveObject SetAll
SaveAsClass
ZOrder
WriteExpression
Error
Init
Valid
When
ReadExpression
ResetToDefault
WriteMethod
2.24. Класс Page
2.24.1. Использование класса Page
Данный класс является визуальным и контейнером и представляет собой
вкладку формы. Он позволяет создавать переключаемые страницы, на которых могут
размещаться другие различные объект. Предусмотренна возможность обращения к
каждой конкретной странице с помощью индекса.
При применении метода Refresh объекта form, на котором расположен данный
объект, обновляется только активная страница.
2.24.2. Свойства класса Page
PageOrder - указывает номер объекта page в объекте page frame. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Page.PageOrder[ = nOrder]
nOrder - определяет данный номер
Данные свойства класса описаны выше:
ActiveControl
BackColor
BackStyle
BaseClass
Caption
Class
ClassLibrary
ColorSource
ControlCount
Comment
Controls
DragIcon
DragMode
Enabled
FontItalic
FontStrikethru FontUnderline FontCondense
FontExtend
FontName
FontOutline
FontShadow
ForeColor
HelpContextID FontSize
KeyPreview
Name
Parent
ParentClass
Picture
2.24.3. События класса Page
Данные события класса описаны выше:
Activate
Click
DblClick
DragDrop
DragOver
Error
MouseDown
MouseMove
MouseUp
Deactivate
MiddleClick
MouseWheel
Destroy
Init
RightClick
67
2.24.4. Методы класса Page
Данные методы класса описаны выше:
Drag
ReadExpression ReadMethod
SetAll
ResetToDefault WriteExpression
AddObject
RemoveObject
WriteMethod
CloneObject
Refresh
ZOrder
2.25. Класс PageFrame
2.25.1. Использование класса PageFrame
Данный класс является невизуальным и контейнером и представляет собой
макет страницы. Он является контейнером для объектов Pages и организует доступ к
каждому из них, задает для них глобальные свойства (размер, позиция, рамка) и
события.
2.25.2. Свойства класса PageFrame
ActivePage - возвращает номер активной страницы в объекте PageFrame.
Доступно во время програмирования; только для чтения-записи при выполнении.
Синтаксис:
PageFrame.ActivePage
PageCount - указывает число объектов page, содержащихся в объекте page
frame. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
PageFrame.PageCount[ = nPages]
nPages - задает данное число.(по умолчанию 0)
Если уменьшить значение свойства PageCount, то все установки и объекты,
содержащиеся во всех страницах теряются.
PageHeight - задает высоту страницы объекта page. Данное свойство доступно
только для чтения.
Синтаксис:
PageFrame.PageHeight[ = nHeight]
nHeight - задает высоту, используя единицы, заданные в свойстве ScaleMode.
Pages - массив, используемый для доступа к каждому объекту page, входящему
в объект page frame. Данное свойство доступно только во время выполнения.
Синтаксис:
PageFrame.Pages(Index).Property[ = Expr]
Index - представляет индекс страницы к которой требуется доступ.
Expr - задает имя свойства страницы.
PageWidth - задает ширину страницы объекта page. Доступно во время
програмирования; только для чтения при выполнении..
Синтаксис:
PageFrame.PageWidth[ = nWidth]
nWidth - задает ширину, используя единицы, заданные в свойстве ScaleMode.
Tabs - указывает имеет ли объект page frame заголовки. Данное свойство
доступно как во время разработки так и выполнения.
Синтаксис:
PageFrame.Tabs[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.) (по умолчанию) имеет.
False (.F.) объект page frame не имеет.
TabStretch - определяет действия, если заголовок не помещается на объекте
page frame. Данное свойство доступно, если свойство Tabs установлено в true (.T.).
Данное свойство доступно как во время разработки так и выполнения.
68
PageFrame.TabStretch[ = nSetting]
nSetting - имеет следующие допустимые значения:
0
Stack.
-создается еще одна строка.
1
(по умолчанию) Clip. -заголовок урезается.
Данные свойства класса описаны выше:
BaseClass
BorderColor
BorderWidth
ColorSource
Comment
DragMode
ParentClass
RightToLeft
Left
SpecialEffect
TabIndex
TabStop
2.25.3. События класса PageFrame
Данные события класса описаны выше:
Click
DblClick
Destroy
Init
MiddleClick
MouseDown
Resize
MouseWheel
RightClick
Class
Enabled
Name
Top
DragDrop
MouseMove
UIEnable
2.25.4. Методы класса Page
Данные методы класса описаны выше:
AddObject
CloneObject
Drag
Move
ReadMethod
Refresh
RemoveObject SetAll
SaveAsClass
ZOrder
WriteExpression
Width
ClassLibrary
Height
Parent
Visible
DragOver Error
MouseUp Moved
ReadExpression
ResetToDefault
WriteMethod
2.26. Класс Relation
2.26.1. Использование класса Relation
Данный класс позволяет задавать связи двух таблиц. Установка значений
свойств этого класса вызывает ошибку. Для того чтобы новое значение свойства
вступило в дейятвие, необходимовыпонить методы CloseTables и OpenTables для
объекта data environment.
2.26.2. Свойства класса Relation
ChildAlias - задает псевдоним дочерней таблицы.Только для чтения при
выполнении и во время програмирования.
Синтаксис:
DataEnvironment.Relation.ChildAlias[ = cText]
cText - определяет данное имя
OneToMany - определяет тип связи. Доступно во время програмирования;
только для чтения при выполнении.
Синтаксис:
Object.DataEnvironment.Relation.OneToMany[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
-указатель записи остается на той же родительской записи, пока
указатель дочерней таблицы передвигается через все связанные записи дочерней
таблицы
False (.F.)
(по умолчанию) указатель записи родительской таблицы
передвигается, а указатель дочерней таблицы устанавливается на первую связанную
запись дочерней таблицы
ParentAlias - определяет псевдоним родительской таблицы. Только для чтения.
69
Синтаксис:
DataEnvironment.Relation.ParentAlias[ = cAliasName]
cAliasName - указывает данное имя.
Данные свойства класса описаны выше: ChildOrder, Name, RelationalExpr
2.26.3. События класса Relation
Данные события класса описаны выше:
2.26.4. Методы класса Relation
Данные метод класса описан выше:
Destroy
Error
Init
ResetToDefault
2.27. Класс Separator
2.27.1. Использование класса Separator
Данный класс является визуальным и неконтейнером и представляет собой
разделитель. Он помещает пробелы между объектами в панели инструментов и
создает группы объектов.
2.27.2. Свойства класса Separator
Данные свойства класса описаны выше:
BaseClass
Class
ClassLibrary
HelpContextID
Name
ParentClass
2.27.3. Методы класса Separator
Данные методы класса описаны выше:
Enabled
SaveAsClass
ZOrder
2.28. Класс Shape
2.28.1. Использование класса Shape
Данный класс является визуальным и неконтейнером и представляет собой
обрамление. Он может изображать прямоугольник, круг и эллипс. Этот класс как и
все имеет свои собственные свойства, события и методы.
2.28.2. Свойства класса Shape
Curvature - используется для придания объекту формы, отличной от
прямоугольника. Данное свойство доступно как во время разработки так и
выполнения.
Синтаксис:
Shape.Curvature[ = nCurve]
nCurve - имеет следующие допустимые значения:
0
-обычные прямые углы.
1 - 98 -различная степень сглаживания.
99
-создается эллипс или круг.
Данные свойства класса описаны выше:
BackColor
BackStyle
BaseClass
BorderColor
BorderStyle
BorderWidth
Class
ClassLibrary
ColorScheme
ColorSource
Comment
DragIcon
DragMode
DrawMode
Enabled
FillColor
FillStyle
Height
HelpContextID Left
70
MousePointer
Name
SpecialEffect
Tag
ToolTipText
Parent
ParentClass
Top
Visible
Width
DragDrop
MouseDown
UIEnable
DragOver
MouseMove
2.28.3. События класса Shape
Данные события класса описаны выше:
Click
DblClick
Destroy
Error
Init
MiddleClick
MouseUp
MouseWheel
RightClick
2.28.4. Методы класса Shape
Данные методы класса описаны выше:
CloneObject
Drag
Move
SaveAsClass
WriteExpression
ReadExpression
WriteMethod
ReadMethod
Zorder
2.29. Класс Spinner
2.29.1. Использование класса Spinner
Данный класс является визуальным и неконтейнером и представляет собой
счетчик. Он позволяет изменять значение определенной величины с помощью
специальных кнопок, задавать для этой величины максимальное и минимальное
значение и многое другое..
2.29.2. Свойства класса Spinner
Increment - указывает шаг изменения величины для объекта Spinner. Данное
свойство доступно как во время разработки так и выполнения.
Синтаксис:
Spinner.Increment[ = nIncrement]
nIncrement - значение шага (по умолчанию 1.00).
KeyboardHighValue, KeyboardLowValue - определяет соответственно
максимальное и минимальное значение, которое можно ввести в объект Spinner с
клавиатуры. Данное свойство доступно как во время разработки так и выполнения.
Синтаксис:
Spinner.KeyboardHighValue[ = nHigh]
Spinner.KeyboardLowValue[ = nLow]
nHigh - максимальное значение ( по умолчанию 2,147,483,647).
nLow - минимальное значение ( по умолчанию – 2,147,483,647).
SpinnerHighValue,
SpinnerLowValue
определяет
соответственно
максимальное и минимальное значение, которое можно ввести в объект Spinner с
использованием стрелок вверх и вниз. Данное свойство доступно как во время
разработки так и выполнения.
Синтаксис:
Spinner.SpinnerHighValue[ = nHigh]
Spinner.SpinnerLowValue[ = nLow]
nHigh - максимальное значение.
nLow - минимальное значение.
Данные свойства класса описаны выше:
Alignment
BackColor
BaseClass
BorderStyle
Class
ClassLibrary
ColorScheme
ColorSource
Comment ControlSource
71
DisabledBackColor
DisabledForeColor
DragMode
Enabled
FontBold
FontCondense
FontItalic
FontName
FontOutline
FontShadow
FontStrikeThru FontUnderline ForeColor
Format
HelpContextID HideSelection
InputMask
Left
MousePointer
Name
Parent
ParentClass
RightToLeft
SelectedBackColor
SelectedForeColor
SelStart
SelText
SpecialEffect
StatusBarText
TabStop
TerminateRead ToolTipText
Top
Tag
Value
Visible
Width
2.29.3. События класса Spinner
Данные события класса описаны выше:
Click
DblClick
Destroy
DragOver
Error
ErrorMessage
InteractiveChange
KeyPress
MiddleClick
MouseDown
MouseMove
ProgrammaticChange
RangeHigh
UIEnable
UpClick
Valid
2.29.4. Методы класса Spinner
Данные методы класса описаны выше:
CloneObject
Drag
Move
Refresh
SaveAsClass
SetFocus
DownClick
GotFocus
LostFocus
MouseUp
RangeLow
When
ReadExpression
WriteExpression
DragIcon
FontExtend
FontSize
Height
Margin
ReadOnly
SelLength
TabIndex
Text
DragDrop
Init
Message
MouseWheel
RightClick
ZOrder
ReadMethod
WriteMethod
2.30. Класс TextBox
2.30.1. Использование класса TextBox
Данный класс является визуальным и неконтейнером и представляет собой поле
ввода. Он применяется для редактирования сивольных переменных, элементов
массивов, полей или полей memo. Поддерживаются все стандартные возможности:
такие как копирование, вставка и перемещение в буфер. Если тип редактируемой
величины дата или дата-время, то если выделить целиком данное значение, то
нажатием + или - можно увеличивать или уменьшать данное значение на день.
2.30.2. Свойства класса TextBox
MemoWindow, OpenWindow - включено для совместимости.
PasswordChar - определяет вид символов, изображаемых вместо реально
нажатых при вводе пароля для обеспечения секретности. Данное свойство доступно
как во время разработки так и выполнения.
Синтаксис:
TextBox.PasswordChar[ = cCharString]
cCharString - Specifies the characters displayed in a text box.
Данные свойства класса описаны выше:
Alignment
BackColor
BackStyle
BaseClass
BorderStyle
Class
ClassLibrary
ColorScheme
ColorSource
Comment
ControlSource DisabledBackColor
DisabledForeColor
DragIcon
72
DragMode
Enabled
FontCondense
FontBold
FontExtend
FontItalic
FontName
FontOutline
FontShadow
FontSize
FontStrikeThru FontUnderline ForeColor
Format
Height
HelpContextID HideSelection
MousePointer
MaxLength
Margin
Name
RightToLeft
ParentClass
ReadOnly
Parent
SelectedBackColor
SelectedForeColor
SelText
SpecialEffect
StatusBarText Style
TabIndex
TabStop Tag Style
Top
TerminateRead Text
ToolTipText
Value
Visible
Width
SelectOnEntry SelLength SelStart
Left
Value
InputMask
2.30.3. События класса TextBox
Данные события класса описаны выше:
Click
DblClick
Destroy
Error
ErrorMessage
GotFocus
KeyPress LostFocus
Message
Valid
MouseMove
MouseUp
ProgrammaticChange
RangeLow
DragDrop
Init
MiddleClick
MouseWheel
RightClick
2.30.4. Методы класса TextBox
Данные методы класса описаны выше:
CloneObject
Drag
Move
Refresh
SetFocus SaveAsClass
WriteMethod
ReadExpression
ResetToDefault
When
DragOver
InteractiveChange
MouseDown
RangeHigh
UIEnable
ZOrder
ReadMethod
WriteExpression
2.31. Класс Timer
2.31.1. Использование класса Timer
Данный класс является невизуальным и неконтейнером и представляет собой
таймер. Он используется для определения интервалов времени и выполнении в этот
момент различных действий.
2.31.2. Свойства класса Timer
Interval - задает число милисекунд времени между
событием Timer. Данное свойство доступно как во
выполнения.
Синтаксис:
Timer.Interval[ = nTime]
nTime - указывает данное число.
Данные свойства класса описаны выше:
BaseClass Class
ClassLibrary
Comment
Left
Name
Parent
ParentClass
вызовом объекта Timer и
время разработки так и
Enabled
Tag
Height
Top Width
2.31.3. События класса Timer
Timer - когда истекает интервал времени, заданный свойством Interval.
Синтаксис:
PROCEDURE Timer.Timer
[LPARAMETERS nIndex]
nIndex - уникальный идентификатор объекта, если он входит в множество объектов .
73
Данные события класса описаны выше:
Destroy
2.31.4. Методы класса Timer
Данные методы класса описаны выше:
CloneObject
ReadExpression
ReadMethod
SaveAsClass
WriteExpression
Reset
Error
Init
ResetToDefault
WriteMethod
2.32. Класс ToolBar
2.32.1. Использование класса ToolBar
Данный класс является визуальным и контейнером и представляет собой панель
управления. Он используется для создания в приложениях пользователя панели
инструментов, которая может содержать различные объекты. Для панели
инструментов характерны следующие свойства:
· панель инструментов всегда «наверху»
· панель инструментов автоматически уменьшается когда подходит к краю
главного окна Visual FoxPro.
· когда данный объект не уменьшен, его размер - половина заголовка формы.
· когда размер панели инструментов меняется, то объекты, входящие в нее,
также изменяют свои размеры.
· кнопки доступа, для объектов входящих в панель инструментов, не доступны.
2.32.2. Свойства класса ToolBar
Docked - указывает, зафиксированно ли положение объекта ToolBar.
Синтаксис:
ToolBar.Docked[ = lExpr]
lExpr - имеет следующие допустимые значения:
True (.T.)
объект toolbar зафиксирован.
False (.F.)
объект toolbar не зафиксирован.
DockPosition - указывает позицию, где находится зафиксированный объект
ToolBar. Только для чтения.
Синтаксис:
ToolBar.DockPosition[= nPosition]
nPosition - имеет следующие допустимые значения:
–1
-объект toolbar не зафиксирован
0
-объект toolbar зафиксирован вверху
1
-объект toolbar зафиксирован слева
2
-объект toolbar зафиксирован справа
3
-объект toolbar зафиксирован снизу
Данные свойства класса описаны выше:
ActiveControl
BackColor
BaseClass
Caption
Class
ClassLibrary
Comment
ColorSource
ControlBox
ControlCount
Controls
DataSession
DataSessionID
Enabled
ForeColor
Height
HelpContextID
KeyPreview
Left
MousePointer
Movable
LockScreen
Parent
ParentClass
ShowTips Name
Top
Sizable
ScaleMode
Visible
Width
74
2.32.3. События класса ToolBar
AfterDock - имеет место после того как фиксируется панель инструментов.
Синтаксис:
PROCEDURE ToolBar.AfterDock
[LPARAMETERS nIndex]
nIndex - уникальный идентификатор объекта, если он входит в множество объектов .
BeforeDock - имеет место перед фиксацией объекта ToolBar.
Синтаксис:
PROCEDURE ToolBar.BeforeDock
LPARAMETERS [nIndex] , nLocation
nIndex - данный параметр описан выше.
nLocation - имеет следующие допустимые значения:
-1
объект ToolBar не зафиксирован.
0
объект ToolBar зафиксирован наверху главного окна VisualFoxPro.
1
объект ToolBar зафиксирован слева на главном окне VisualFoxPro.
2
объект ToolBar зафиксирован справа на главном окне VisualFoxPro.
3
объект ToolBar зафиксирован внизу главного окнаVisualFoxPro.
UnDock - имеет место при перемещении объекта ToolBar с помощью мыши.
Синтаксис:
PROCEDURE ToolBar.Undock
[LPARAMETERS nIndex]
nIndex - данный параметр описан выше.
Данные события класса описаны выше:
Activate
Click
DblClick
Deactivate
Destroy
DragDrop
DragOver
Error
MiddleClick
Init
MouseDown
MouseMove
MouseUp
MouseWheel
Moved
Paint
Resize
RightClick
2.32.4. Методы класса ToolBar
Dock - располагает объект ToolBar у границы основного окна VisualFoxPro.
Синтаксис:
ToolBar.Dock(nLocation [, X, Y])
nLocation - данный параметр описан выше.
X, Y - содержат горизонтальные и вертикальные координаты позиции объекта.
Данные методы класса описаны выше:
ZOrder
AddObject
CloneObject
Hide
Move
Refresh
RemoveObject ResetToDefault
SaveAsClass
SetAll
Show
2.33. Класс ActiveDocument
2.33.1. Использование класса ActiveDocument
Данный невизуальный базовый класс Visual FoxPro появился начиная с версии
Visual FoxPro6.0 и используется для создания так называемых активных документов,
которые могут входить в приложения содержащие такие документы, например
Microsoft Internet Explorer. Этот класс осуществляет программный доступ к
свойствам класса и к событиям, происходящим при доступе к нему извне. Также
он используется как базовый класс для приложений с помощью которых создаются
файлы .APP или .EXE.
2.33.2. Свойства класса ActiveDocument
75
ContainerReleaseType - указывает оставаться ли открытым объекту
ActiveDocument когда он удален своим источником. Данное свойство доступно как
во время разработки так и выполнения.
Синтаксис:
Object.ContainerReleaseType[ = nExpression]
nExpression - имеет следующие допустимые значения:
0
-(по умолчанию)объект остается открытым ActiveDocument в главном окне
Visual FoxPro.
1
-объект ActiveDocument закрывается и останавливается.
Данные свойства класса описаны выше:
Application
BaseClass
Caption
Class
ClassLibrary
Comment
Name
Parent
Tag
ParentClass
2.33.3. События класса ActiveDocument
CommandTargetExec - происходит когда источник объекта ActiveDocument
подает команды на его выполнение.
Синтаксис:
PROCEDURE Object.CommandTargetExec
[LPARAMETERS nCommandID, nExecOption, eArgIn, eArgOut]
nCommandID - параметр источника объекта ActiveDocument, указывающий действие.
nExecOption - параметр, указывающий особенности данного действия.
eArgIn, eArgOut - параметры, используемые для работы с источником объекта
ActiveDocument
CommandTargetQuery - происходит когда источник объекта ActiveDocument
обновляет его пользовательский интерфейс.
Синтаксис:
PROCEDURE Object.CommandTargetQuery
[LPARAMETERS aCommands, nCommandTextFlag, cCommandTextOut]
aCommands - двумерный массив команд источника объекта ActiveDocument.
nCommandTextFlag - тип командной информации.
cCommandTextOut - текст, изображаемый для команд (обычно текст строки статуса
источника объекта ActiveDocument).
ContainerRelease - происходит источник объекта ActiveDocument удаляет
данный объект.
Синтаксис:
PROCEDURE Object.ContainerRelease
Run - происходит когда объект ActiveDocument готов исполнить код
пользователя.
Синтаксис:
PROCEDURE ActiveDoc.Run
LPARAMETERS cHyperlinkTarget
cHyperlinkTarget - параметр, передающийся из URL (Universal Resource Locator)
когда для запуска объекта используется протокол HTTP (Hypertext Transfer Protocol)
HideDoc - происходит когда вы уходите из объекта Active Document.
Синтаксис:
PROCEDURE Object.HideDoc
ShowDoc происходит когда вы возвращаетесь а объект Active Document.
Синтаксис:
PROCEDURE Object.ShowDoc
Данные события класса описаны выше:
Destroy
Error
Init
2.33.4. Методы класса ActiveDocument
Данные методы класса описаны выше:
AddProperty
ReadExpression
76
ReadMethod
ResetToDefault
SaveAsClass
WriteExpression
2.34. Класс Hyperlink
2.34.1. Использование класса Hyperlink
Данный невизуальный базовый класс Visual FoxPro появился начиная с версии
Visual FoxPro6.0 и используется для обеспечения навигационных возможностей
приложений и классов Active Document Visual FoxPro находящихся в приложенияхконтейнерах данных объектов, например Microsoft Internet Explorer. Используя класс
Hyperlink, приложения Visual FoxPro могут запросить приложение-контейнер
активных документов перейти к заданному адресу URL (Uniform Resource Locator).
Необходимо помнить, что класс Hyperlink поддерживается только в Microsoft
Internet Explorer.
2.34.2. Свойства класса Hyperlink
Данные свойства класса описаны выше:
Application
BaseClass
Class
Name
Parent
Tag
2.34.3. События класса Hyperlink
Данные события класса описаны выше:
ClassLibrary
Destroy
Comment
ParentClass
Error
Init
2.34.4. Методы класса Hyperlink
GoBack - перемещение назад по маршрутному листу источника объекта Active
Document.
Синтаксис:
HyperLink.GoBack( )
GoForward - перемещение вперед по маршрутному листу источника объекта
Active Document.
Синтаксис:
HyperLink.GoForward( )
NavigateTo - перемещение в заданное место объекта Active Document.
Синтаксис:
Object.NavigateTo(cTarget [, cLocation [, cFrame]])
cTarget - указывает адрес URL.
cLocation - указывает место определяемое в пределах cTarget.
cFrame
- указывает структуру, определяемую в пределах cTarget.
Данные методы класса описаны выше:
AddProperty
ReadExpression
ReadMethod
ResetToDefault
SaveAsClass
WriteExpression
2.35. Класс ProjectHook
2.35.1. Использование класса ProjectHook
Данный невизуальный класс является базовым для Visual FoxPro и появился
начиная с версии Visual FoxPro6.0. По умолчанию он возникает при открытии
проекта и обеспечивает программный доступ к событиям данного проекта. Имеется
возможность исключить появление для проекта класса ProjectHook, для чего
необходимо установить NOPROJECTHOOK при использовании команд CREATE
PROJECT или MODIFY PROJECT. Данный класс может быть создан командами
CREATE CLASS, CREATEOBJECT( ) или NEWOBJECT( ).
77
2.35.2. Свойства класса ProjectHook
Данные свойства класса описаны выше:
Application
BaseClass
Class
ClassLibrary
OLEDropEffects
OLEDropHasData
Name
Parent
Tag
Comment
OLEDropMode
ParentClass
2.35.3. События класса ProjectHook
AfterBuild - происходит после компиляции, создании приложения (.app),
библиотеки (.dll) исполняемого файла (.exe).
Синтаксис:
PROCEDURE Object.AfterBuild
[LPARAMETERS nError]
nError - номер ошибки.
BeforeBuild - происходит перед компиляцией, созданием приложения (.app),
библиотеки (.dll) или исполняемого файла (.exe).
Синтаксис:
PROCEDURE Object.BeforeBuild
[LPARAMETERS cOutputName, nBuildAction, lRebuildAll, lShowErrors,
lBuildNewGuids]
cOutputName - имя.
nBuildAction - указывает выполненное действие.
lRebuildAll - указывает созданы файлы или переделаны.
lShowErrors - указывает выводить ли ошибки.
lBuildNewGUIDs - указывает создавать ли новые номера GUIDs (globally unique
identifier).
QueryAddFile, QueryModifyFile, QueryRemoteFile, QueryRunFile происходят соответственно перед добавлением, изменением, удалением, запуском
файла в проекте.
Синтаксис:
PROCEDURE Object.QueryAddFile
[LPARAMETERS cFileName]
PROCEDURE Object.QueryModifyFile
[LPARAMETERS oFile, cClassName]
PROCEDURE Object.QueryRemoveFile
[LPARAMETERS oFile, cClassName, lDeleteFile]
PROCEDURE Object.QueryRunFile
[LPARAMETERS oFile]
cFileName, oFile - имя файла.
cClassName - имя класса файла, если файл это библиотека классов (.vcx)
lDeleteFile - указывает удалять файл с диска или только из проекта.
Данные события класса описаны выше:
Destroy
Error
Init
OLEDragDrop
OLEDragOver
OLEGiveFeedback
2.35.4. Методы класса ProjectHook
Данные методы класса описаны выше:
ReadMethod
ResetToDefault
AddProperty
SaveAsClass
ReadExpression
WriteExpression
78
Список использованных источников
1. Каратыгин С.В. Visual FoxPro 5.0; Полное руководство пользователя с примерами.
- М.: Диалог, 1997 - 329 с.
2. Омельченко Л.Н. Самоучитель по Visual FoxPro 6.0. - СПб.: БХВ, 1999 - 512 с.
3. Справочная система Visual FoxPro 5.0.
4. Справочная система Microsoft Developer Network Library Visual Studio 6.0.