ТабличноеПоле ТабличноеПоле icon

ТабличноеПоле ТабличноеПоле



НазваниеТабличноеПоле ТабличноеПоле
Дата17.10.2016
Размер
ТипУроки, сочинения

ТабличноеПоле


ТабличноеПоле

Элемент управления, представляющий данные в виде таблицы. Работает со специальными объектами – источниками данных, называемыми поставщиками данных табличного поля. Поставщики данных обеспечивают специальный интерфейс, через который табличное поле получает данные. Само табличное не работает с источниками данных (базой данных, файлом, таблицами в памяти и т.п.), оно пользуется только тем, что предоставляет ему поставщик данных.

Табличное поле может генерироватьсобытия в виде вызова процедур модуля формы на которой оно расположено, имена которых должны быть составлены из имени реквизита формы и имени события. Каждое событие, кроме описанных параметров, всегда имеет первый параметр, имеющий значение объекта, источника событий (само табличное поле).


Методы:

RefreshRows()/ОбновитьСтроки()

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


Свойства:

Columns/Колонки

Тип: КолонкиТабличногоПоля (чтение)

Коллекция колонок табличного поля.


DataProvider/ПоставщикДанных

Тип: объект.

Поставщик данных табличного поля.


VScroller/ВертСкроллер

Тип: Число.

Наличие вертикальной полосы прокрутки.

0 – Автоматически скрывать, если все строки помещаются в табличном поле.

1 – Всегда присутствует.

2 – Всегда отсутствует.


StartView/НачальноеПредставление

Тип: Число.

Используется для определения начального заполнения табличного поля, когда в него установлен поставщик данных.

0 – с начала;

1 – с конца.


RowSelectMode/РежимВыделенияСтроки

Тип: Число.

Определяет стиль выделения текущей строки.

0 – выделяется ячейка.

1 – выделяется вся строка.


VerticalLines/ВертикальныеЛинии

Тип: Число.

Определяет наличие вертикальных разделительных линий между ячейками.

0 – линии не отображаются, 1 – линии отображаются.


HorizontalLines/ГоризонтальныеЛинии

Тип: Число.

Определяет наличие горизонтальных разделительных линий между ячейками.

0 – линии не отображаются, 1 – линии отображаются.


HeadersStyle/СтильЗаголовков

Тип: Число.

Определяет стиль отрисовки заголовков колонок.

0 – стиль 3D;

1 – плоский стиль.


CurrentColumn/ТекущаяКолонка

Тип: КолонкаТабличногоПоля.

Определяет текущую колонку табличного поля.


CurrentData/ТекущиеДанные

Тип: ДанныеСтроки. (чтение)

Коллекция значений полей данных источника данных табличного поля. Данные текущей строки.


Font/Шрифт

Тип: Шрифт.

Шрифт по умолчанию для колонок, строк, заголовков и ячеек табличного поля. Определяет также высоту строки табличного поля. Высота строки будет определяться по высоте строки текста этого шрифта. Значение Авто означает, что будет использоваться шрифт формы. По отношению ко всем остальным дочерним объектам табличного поля (колонка, строка, ячейка) этот шрифт будет шрифтом с самым низким приоритетом.

Значение Авто в свойствах типа Шрифт дочерних объектов означает, что будет выбран шрифт с меньшим приоритетом.


RefreshTimeout/ТаймаутОбновления

Тип: Число.

Интервал времени (в секундах), через который выполняется автоматическое обновление данных табличного поля.

0 – автоматически не обновлять.


QuickSearchTimeout/ТаймаутБыстрогоПоиска

Тип: Число.

Интервал времени (в миллисекундах), через который выполняется попытка найти строку по введенным данным.

0 – автоматически не пытаться.


События:

ПриВыводеСтроки(ОформлениеСтроки, ДанныеСтроки)

Возникает при выводе (отображении) строки табличного поля.

- ОформлениеСтроки – тип: ОформлениеСтроки.

Объект для управления оформлением выводимой строки табличного поля.

- ДанныеСтроки – тип: ДанныеСтроки

Коллекция значений полей данных источника данных табличного поля.


Выбор()

Возникает при двойном клике на строке табличного поля, или нажатии клавиши Enter.


ПриАктивизацииСтроки()

Возникает, когда строка становится текущей.


ПриАктивизацииКолонки()

Возникает, когда колонка становится текущей.


ПриАктивизацииЯчейки()

Возникает, когда ячейка становится текущей.

Порядок прохождения событий: ПриАктивизацииСтроки, ПриАктивизацииКолонки, ПриАктивизацииЯчейки.


ПриВыбореЗаголовка(Колонка)

Возникает, когда пользователь выбирает мышью заголовок колонки.

- Колонка – тип: КолонкаТабличногоПоля.

Колонка, заголовок которой выбран.


ПриКонтекстномМеню()

Возникает, когда необходимо отобразить контекстное меню.


ПриВыбореФлажка()

Возникает, когда пользователь изменяет значение флажка.


КолонкиТабличногоПоля (коллекция)

Коллекция колонок табличного поля. Элементы коллекции – объекты типа КолонкаТабличногоПоля.

Индексы колонок – от нуля до количество колонок минус один.


Методы:

Count()/Количество()

Получить количество колонок.

Возвращает: Число, количество колонок.


Get()/Получить(Колонка)

Получить колонку табличного поля.

- Колонка – тип: Число, Строка.

Индекс или имя колонки.

Возвращает: КолонкаТабличногоПоля.


IndexOf()/Индекс(Колонка)

Получить индекс колонки.

- Колонка – тип: КолонкаТабличногоПоля.

Колонка индекс которой требуется получить.

Возвращает: Число – индекс колонки, или -1, если колонка не принадлежит табличному полю.


Add()/Добавить(Имя)

Добавляет колонку в табличное поле.

- Имя – тип: Строка.

Имя добавляемой колонки.

Возвращает: КолонкаТабличногоПоля – созданная колонка.


Insert()/Вставить(Имя,Индкс)

Вставляет колонку в табличное поле.

- Имя – тип: Строка.

Имя вставляемой колонки.

- Индекс – тип: Число.

Индекс вставляемой колонки.

Возвращает: КолонкаТабличногоПоля – созданная колонка.


Remove()/Удалить(Индекс)

Удаляет колонку из табличного поля.

- Индекс – тип: Число.

Индекс удаляемой колонки.


Clear()/Очистить()

Удаляет все колонки в табличном поле.


Свойства:

<ИмяКолонки> (чтение)

Тип: КолонкаТабличногоПоля


КолонкаТабличногоПоля

Объект для управления колонкой табличного поля.


Методы:

SetRowsPictures()/УстановитьКартинкиСтрок(Картинки, Ширина)

Устанавливает набор картинок для отображения в ячейках этой колонки. Картинками считаются части общей переданной первым параметром картинки, полученные по следующим правилам: от левого верхнего угла слева направо, ширина равна высоте. Выбирается только первый ряд. Прозрачным является цвет RGB(0x00, 0x80, 0x80). Картинки будут доступны по индексу (от нуля).

- Картинки – тип: Картинка.

Картинка – из которой будут получены отдельные пиктограммы для отображения в ячейках.

- Ширина – тип: Число. Необязателен, по умолчанию 0.

Ширина отдельной пиктограммы для отображения. Если равна нулю, ширина определяется высотой переданной картинки.


Свойства:

Name/Имя

Тип: Строка.

Имя колонки.


Caption/Заголовок

Тип: Строка.

Текст заголовка колонки.


Visible/Видимость

Тип: Число.

Видимость колонки.

0 – невидима, 1 – видима.


Width/Ширина

Тип: Число.

Ширина колонки в пикселях.


HorizontalAlignment/ГоризонтальноеВыравнивание

Тип: Число.

Определяет правило выравнивания текста в ячейках колонки по горизонтали.

0 – автоматически, в зависимости от типа поля данных, отображаемого в колонке;

1 – прижать влево;

2 – прижать вправо;

3 – центрировать;


ИзменениеРазмера/SizeChange

Тип: Число.

Определяет возможность интерактивного изменения ширины колонки.

0 – запрещено, 1 – разрешено;


TextColor/ЦветТекста

Тип: Число.

Цвет текста строк.


BackColor/ЦветФона

Тип: Число.

Цвет фона строк.


Font/Шрифт

Тип: Шрифт.

Шрифт строк. Приоритет выше, чем у свойства Шрифт табличного поля.


HeaderFont/ШрифтЗаголовка

Тип: Шрифт.

Шрифт заголовка. Приоритет выше, чем у свойства Шрифт табличного поля.


HeaderTextColor/ЦветТекстаЗаголовка

Тип: Число.

Цвет текста заголовка.


HeaderBackColor/ЦветФонаЗаголовка

Тип: Число.

Цвет фона заголовка.


DataField/Данные

Тип: Строка.

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


OrderMarker/ЗнакУпорядочивания

Тип: Число.

Определяет вывод значка упорядочивания в заголовке колонки.

0 – не отображается;

1 – по возрастанию;

2 – по убыванию;

3 – по возрастанию второе поле;

4 – по убыванию второе поле;

5 – по возрастанию третье поле;

6 – по убыванию третье поле;


ДанныеСтроки (фиксированная коллекция)

Коллекция значений полей данных, полученных табличным полем от поставщика данных. Элементы коллекции – значения полей поставщика.


Методы:

Count()/Количество()

Получить количество элементов.

Возвращает: Число.

Количество полей.


Get()/Получить(Поле)

Получить значение поля.

- Поле – тип: Число, Строка.

Имя или индекс поля данных.

Возвращает: Любой.

Значение поля данных.


Свойства:

<ИмяПоляДанных> (чтение)

Тип: Любой.

Значение поля данных.


ОформлениеСтроки

Объект для управления оформлением строки табличного поля.


Свойства:

RowData/ДанныеСтроки (чтение)

Тип: ДанныеСтроки.

Данные строки. Коллекция значений полей для строки табличного поля..


Cells/Ячейки (чтение)

Тип: ФиксированнаяКоллекция.

Коллекция ячеек строки табличного поля. Элементы коллекции – объекты типа ОформлениеЯчейки.


TextColor/ЦветТекста

Тип: Число.

Определяет цвет текста всех ячеек строки. Приоритет выше, чем у свойства ЦветТекста колонки табличного поля.


BackColor/ЦветФона

Тип: Число.

Определяет цвет фона всех ячеек строки. Приоритет выше, чем у свойства ЦветФона колонки табличного поля.


Font/Шрифт

Определяет Шрифт всех ячеек строки. Приоритет выше, чем у свойства Шрифт колонки табличного поля.


ОформлениеЯчейки

Объект для управления оформлением ячейки табличного поля.


Методы:

SetText()/УстановитьТекст(Текст)

Устанавливает текст ячейки табличного поля для отображения и свойство ОтображатьТекст в 1.

- Текст – тип: Строка.

Текст, отображаемый в ячейке.


SetPicture()/УстановитьКартинку(Картинка)

Устанавливает картинку ячейки табличного поля и свойство ОтображатьКартинку в 1. Картинка отображается без использования цвета прозрачности. Правила масштабирования картинки задаются в объекте Картинка.

- Картинка – тип: Картинка.

Картинка, отображаемая в ячейке.


SetCheck()/УстановитьФлажок(ЗначениеФлажка)

Устанавливает значение флажка ячейки табличного поля и свойство ОтображатьФлажок в 1.

- ЗначениеФлажка – тип: Число.

Значение флажка, отображаемого в ячейке.

0 – не установлен;

1 – установлен;

2 – неопределенное состояние.


Свойства:

Name/Имя

Тип: Строка.

Имя ячейки. Соответствует имени колонки, которой принадлежит ячейка.


ShowText/ОтображатьТекст

Тип: Число.

Признак отображения текста в ячейке.

0 – не отображать, 1 – отображать;


ShowPicture/ОтображатьКартинку

Тип: Число.

Признак отображения картинки в ячейке.

0 – не отображать, 1 – отображать;


ShowCheck/ОтображатьФлажок

Тип: Число.

Признак отображения флажка в ячейке.

0 – не отображать, 1 – отображать;


HorizontalAlignment/ГоризонтальноеВыравнивание

Тип: Число.

Определяет правило выравнивания текста в ячейке по горизонтали.

0 – автоматически, в зависимости от типа поля данных, отображаемого в колонке;

1 – прижать влево;

2 – прижать вправо;

3 – центрировать;


PictureIndex/ИндексКартинки

Тип: Число.

Определяет индекс картинки для отображения в ячейке. Картинки должны быть предварительно установлены в соответствующей колонке.

См. свойство КартинкиСтрок, объекта КолонкаТабличногоПоля.


CheckValue/ЗначениеФлажка

Тип: Число.

Определяет значение флажка ячейки табличного поля.

Значение флажка отображаемого в ячейке.

0 – не установлен;

1 – установлен;

2 – неопределенное состояние.


Text/Текст

Тип: Строка.

Определяет текст ячейки табличного поля.


TextColor/ЦветТекста

Тип: Число.

Определяет цвет текста ячейки табличного поля. Приоритет выше, чем у свойства ЦветТекста строки табличного поля.


BackColor/ЦветФона

Тип: Число.

Определяет цвет фона ячейки табличного поля. Приоритет выше, чем у свойства ЦветФона строки табличного поля.


Font/Шрифт

Тип: Шрифт.

Определяет шрифт текста ячейки табличного поля. Приоритет выше, чем у свойства Шрифт строки табличного поля.


^ Поставщики данных


ODBCDataProvider/ПоставщикДанныхODBC.<ТипИсточника>

Поставщик данных для табличного поля. Используется для отображения в табличном поле таблиц баз данных. Для получения данных объект использует драйвер ODBC. Подключение задается объектом ODBCDatabase.

Получаемые данные определяются SQL запросом. Формат SQL запроса определяется строже, чем общий формат sql запроса источника данных или драйвера ODBC.

Возможно использование метаимен и типизации полей, как определено для объекта ODBCRecordset.

Данные получаются частями по несколько записей, как это необходимо для отображения.

Этот поставщик данных поддерживает функционал исключения полей из текста запроса, если данные не нужны для отображения (по причине удаления или невидимости колонки табличного поля).


Формат запроса:

<Запрос> ::=

SELECT

<ОпределениеПоля> [, …n]

FROM <ИсточникДанных>

[WHERE <Условие>]


<ОпределениеПоля> ::= <ВыражениеПоля> AS <ИмяПоля>

<ВыражениеПоля> ::= <определяется правилами источника данных>

<ИмяПоля> ::= <определяется правилами источника данных>

<ИсточникДанных> ::= <определяется правилами источника данных>

<Условие> ::= <определяется правилами источника данных>


Кроме текста запроса, для работы также необходимо задать ключ порядка. Ключ порядка - это набор полей с указанием упорядочивания (порядка следования записей). Значения этих полей должны однозначно идентифицировать каждую запись.

Формат ключа порядка:

<КлючПорядка> ::= <ЭлементКлючаПорядка> [, …n]

<ЭлементКлючаПорядка> ::= <ИмяПоля> {[ASC] | DESC}

В ключе порядка имя поля необходимо указывать без типизации. (Обратите внимание, что поля из ключа порядка должны быть обязательно определены в запросе.)


Методы:

SetQueryText()/УстТекстЗапроса(ТекстЗапроса)

Устанавливает текст запроса.

- ТекстЗапроса – тип: Строка.

Текст запроса.


SetOrderKey()/УстКлючПорядка(КлючПорядка)

Устанавливает ключ порядка.

- КлючПорядка – тип: Строка.

Текст ключа порядка. Установка возможна только после установки текста запроса.


SetCurrentRow()/УстТекущуюСтроку(ТекущаяСтрока)

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

- ТекущаяСтрока – тип: любой объект, имеющий свойства с именами полей ключа порядка, и соответствующими значениями этих свойств, как значения полей ключа порядка необходимой текущей строки.

Например объект типа Структрура.


Свойства:

Fields/Поля (чтение)

Тип: ПоляДанныхODBC

Коллекция полей поставщика данных.


Database/БазаДанных

Тип: ODBCDataBase

Определяет подключение, через которое поставщик данных будет работать.


QuickSearchType/ТипБыстрогоПоиска

Тип: Число.

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

0 – нет быстрого поиска;

1 – текстовый быстрый поиск.


ПоляДанныхODBC (коллекция)

Коллекция колонок (полей) поставщика данных. Элементы коллекции – объекты типа КолонкаСпискаПоставщикаДанныхODBC.


Методы:

Count()/Количество()

Получить количество элементов.

Возвращает: Число.

Количество полей.


Get()/Получить(Поле)

Получить поле поставщика данных.

- Поле – тип: Число, Строка.

Индекс или имя поля.

Возвращает: ПолеДанныхODBC.


Add()/Добавить(Имя)

Добавляет поле в список получаемых от источника данных. Поле с таким именем должно быть определено в запросе. Если поле с таким именем уже присутствует с коллекции – добавления не происходит.

- Имя – тип: Строка.

Имя добавляемого поля запроса.

Возвращает: ПолеДанныхODBC – добавленное поле.


Remove()/Удалить(Индекс)

Удаляет поле из списка получаемых от источника данных.

- Индекс – тип: Число.

Индекс удаляемого поля. Поля, входящие в состав ключа порядка удалить невозможно.


Clear()/Очистить()

Удаляет все поля из списка, кроме полей, входящих в состав ключа порядка.


Свойства:

<ИмяКолонки>

Тип: ПолеДанныхODBC


ПолеДанныхODBC

Объект для управления полем поставщика данных.


Свойства:

Name/Имя

Тип: Строка.

Имя поля.


AutoDelete/АвтоУдаление

Тип: Число.

Признак разрешения автоматического удаления поля из состава получаемых данных от источника.

0 – запрещено, 1 – разрешено.


<ТипИсточника>

Определяет тип источника данных. От типа источника зависит стиль конечных запросов к серверу. От типа источника также могут зависеть способы и возможности оптимизации.

Определены следующие типы источников данных:


MSSQL

Источником данных должен быть Microsoft SQL Server 7.0 или Microsoft SQL Server 2000. Рекомендуется драйвер: {SQL Server}.


VFP

Источником данных должны быть dbf файлы. Рекомендуется драйвер: {Microsoft Visual FoxPro Driver}.


MySQL

Источником должен быть MySQL Server. Рекомендуется драйвер: {MySQL ODBC 3.51 Driver}.


Oracle

Источником должен быть Oracle8i Database. Рекомендуется драйвер: {Microsoft ODBC для Oracle} или {Oracle ODBC Driver}.


VTProvider/ПоставщикДанныхТЗ

Поставщик данных для табличного поля. Позволяет отобразить данные таблицы значений в табличном поле.


Методы:

SetValueTable()/УстТаблицуЗначений(ТЗ)

- ТЗ – тип: ТаблицаЗначений.

Устанавливает таблицу значений. Она будет использоваться, как источник данных для отображения в табличном поле.


SetCurrentRow()/УстТекущуюСтроку(ТекущаяСтрока)

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

- ТекущаяСтрока – тип: Число.

Индекс строки в таблице значений. (от 0 до «количество строк минус один»)


^ Общие объекты

Шрифт

Объект для определения шрифта текста.


Свойства:

Type/Вид

Тип: Число.

0 – специальное значение объекта типа шрифт, которое означает, что шрифт выбирается автоматически.

1 – абсолютный, шрифт задан именем шрифта, размером и прочими признаками;

2 – OEMFixedFont;

3 – ANSIFixedFont;

4 – ANSIVariableFont;

5 – SystemFont;

6 – DefaultGUIFont.


Name/Имя

Тип: Строка.

Имя шрифта.


Size/Размер

Тип: Число.

Размер шрифта в пунктах.


Bold/Жирный

Тип: Число.

Признак жирности шрифта.

0 – нормальный; 1 – жирный.


Italic/Наклонный

Тип: Число.

Признак наклона шрифта.

0 – нормальный; 1 – наклонный.


Underline/Подчеркивание

Тип: Число.

Признак подчеркивания шрифта.

0 – нормальный; 1 – подчеркнутый.


StrikeOut/Зачеркивание

Тип: Число.

Признак зачеркивания шрифта.

0 – нормальный; 1 – зачеркнутый.


ФабрикаОбъектов

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


Методы:

Шрифт(Вид)

Создается системный шрифт Windows или Авто шрифт.

- Вид – тип: Число.

Вид шрифта. Допустимо указывать любой, кроме значения абсолютный.


Шрифт(Имя, Размер, Жирный, Наклонный, Подчеркивание, Зачеркивание)

Создается абсолютный шрифт.

- Имя – тип: Строка.

Имя шрифта.

- Размер – тип: Число.

Размер в пунктах.

- Жирный – тип: Число.

Признак жирности шрифта.

0 – нормальный; 1 – жирный.

- Наклонный – тип: Число.

Признак наклона шрифта.

0 – нормальный; 1 – наклонный.

- Подчеркивание – тип: Число.

Признак подчеркивания шрифта.

0 – нормальный; 1 – подчеркнутый.

- Зачеркивание – тип: Число.

Признак зачеркивания шрифта.

0 – нормальный; 1 – зачеркнутый.


Шрифт(Шрифт, Имя, Размер, Жирный, Наклонный, Подчеркивание, Зачеркивание)

Создается шрифт на основании другого шрифта. Все параметры кроме первого – необязательны, и если не указано, то этот показатель шрифта не изменяется.

- Шрифт – тип: Шрифт.

Шрифт, на основании которого будет построен новый объект типа шрифт.

- Имя – тип: Строка.

Имя шрифта.

- Размер – тип: Число.

Размер в пунктах.

- Жирный – тип: Число.

Признак жирности шрифта.

0 – нормальный; 1 – жирный.

- Наклонный – тип: Число.

Признак наклона шрифта.

0 – нормальный; 1 – наклонный.

- Подчеркивание – тип: Число.

Признак подчеркивания шрифта.

0 – нормальный; 1 – подчеркнутый.

- Зачеркивание – тип: Число.

Признак зачеркивания шрифта.

0 – нормальный; 1 – зачеркнутый.


Создание:

АтрибутФормы::СоздатьТабличноеПоле()

Атрибут формы должен быть связан с кнопкой. А окно формы должно существовать.




Разместите ссылку на наш сайт:
Уроки, сочинения


База данных защищена авторским правом ©izlov.ru 2000-2014
При копировании материала обязательно указание активной ссылки открытой для индексации.
связаться с нами