Содержимое строки массива, формируемого adir( )
Номер столбца |
Что содержит |
Тип данных |
1 |
Имя файла |
Character |
2 |
Размер файла |
Numeric |
3 |
Дату последнего изменения файла |
Date |
4 |
Время последнего изменения файла |
Numeric |
5 |
Атрибуты файла |
Character |
В строке с атрибутами файла могут находиться следующие символы:
A – архивный (чтение / запись);
H – скрытый;
R – только чтение;
S – системный;
D – директория.
Параметры:
cFileSkeleton – маска, задающая критерии отбора файлов; может содержать символы * и ?. Если директория и диск в маске не указаны, то в ADIR( ) помещает в массив информацию о файлах, имеющихся в текущей директории и удовлетворяющих заданным критериям отбора. Тип маски – Character.
cAttribute – может содержать любую комбинацию символов D, H, S и V, задающую следующие условия отбора:
D – в массив отбираются удовлетворяющие маске имена поддиректорий;
H – в массив отбираются скрытые файлы;
S – в массив отбираются системные файлы;
V – в массиве будет только один элемент, содержащий имя тома, на котором расположена директория по умолчанию. Например, для диска с: на вкладке "Общие" диалога задания свойств диска может быть указано имя SYS.
В директории по умолчанию поддиректории, скрытые или системные файлы заносятся в массив, если для cFileSkeleton указана пустая строка, а для cAttribute соответствующая комбинация символов D, H и S.
nFlag – может принимать следующие значения:
0 – в массив заносятся полные имена файлов и поддиректорий, все буквы имен прописные;
1 – то же, что и в случае 1, но регистр букв сохраняется;
2 – имена заносятся в соответствии с правилами DOS (не более 8-и символов для имени и 3-х для расширения).
Пример 1. Выводятся имена имеющихся на диске с: поддиректорий, системных и скрытых файлов.
&& Устанавливаем директорию по умолчанию
set default to c:
Adir(fileArray, "", "SDH")
&& Печатаем состав массива fileArray
display memory like fileArray
Пример 2. Выводятся имена имеющихся на диске d: файлов с программами VFP.
Adir(fileArray, "d:\*.prg")
display memory like fileArray
Функция
ADLLS(ArrayName)
формирует двумерный массив ArrayName, содержащий имена функций, загруженных командой DECLARE – DLL. В каждой строке массива ее первый элемент содержит имя функции, второй – псевдоним функции, третий – имя библиотеки. Тип данных – Character. Функция возвращает число строк результирующего массива.
Функция
ADOCKSTATE(ArrayName [, nType | nExtended])
заносит в массив ArrayName вариант прикрепления всех прикрепляемых IDE-окон и панелей инструментов, как системных, так и пользовательских (IDE – integrated development environment). Функция возвращает число строк в результирующем массиве.
Содержимое каждой строки массива описано в табл. 6.4.
Таблица 6.4
Содержимое строки массива, формируемого adockstate( )
Номер элемента |
Что содержит |
Тип данных |
1 |
Имя IDE-окна или панели инструментов. В случае пользовательской панели инструментов содержит значение ее свойства Caption |
Character |
2 |
Вариант прикрепления (1 – прикрепленное, 0 – нет) |
Numeric |
3 |
Позиция прикрепления; возможны следующие значения: –1 – контейнер не прикреплен; 0 – верхнее прикрепление; 1 – левое, 2 – правое; 3 – нижнее; 4 – вложенное. Позиция указывается относительно окна, имя которого хранит первый элемент строки |
" |
4 |
Само окно или имя окна, к которому прикреплено рассматриваемое окно в случае смежного или вложенного прикрепления. Для панелей инструментов и окон, прикрепленных к главному окну VFP, содержит имя главного окна, хранимое свойством Caption объекта _VFP. Если панель инструментов появляется между главным окном VFP и прикрепленным к нему окном, то элемент содержит имя панели инструментов. При отсутствии прикрепления содержит пустую строку |
Character |
5 |
Ссылка на прикрепляемое окно или панель инструментов. Заполняется, только когда прикрепляется пользовательское окно или панель инструментов. В случае IDE-окна этот элемент содержит пустую строку |
Object |
6 |
Ссылка на пользовательское или главное окно VFP окно, к которому выполняется прикрепление. В последнем случае элемент месива содержит ссылку на системную переменную _SCREEN. В случае IDE-окна элемент содержит пустую строку |
Object |
Параметры:
nType – задает вид возвращаемого результата:
0 – возвращаются данные для всех окон (по умолчанию);
1 – возвращает данные только для IDE-окон;
2 – возвращает данные только для панелей инструментов;
3 – возвращает данные только определенных пользователем форм.
nExtended – задает число столбцов в массиве:
0 – формирует массив с 4-я столбцами для окон и панелей инструментов;
1 – формирует массив с 6-ю столбцами для форм;
При вложенном прикреплении VFP левое окно содержит сведения о прикреплении всего контейнера; порядок обхода окон – слева направо.
При смежном прикреплении верхнее левое окно содержит сведения о прикреплении всего контейнера; окна обходятся начиная с верхнего левого окна.
При наличии окон как со смежным, так и с вложенным прикреплениями, прежде обходятся окна со смежным прикреплением, затем с вложенным.
Пример. Выполняется вложенное прикрепление окон Command и View (View – старое название окна Data Session, до сих пор используемое в функциях WONTOP( ) и ADOCKSTATE( ) и командах HIDE WINDOW и ACTIVATE WINDOW).
clear all
&& Активизируем окна Command и View
activate window Command
set view on
&& Отменяем возможное прикрепление активизированных окон
dock window Command position –1
dock window View position –1
&& Создаем вложенное прикрепления окон Command и View,
&& располагая окно Command слева (рис. 6.1)
dock window Command position 4 window View
ADockState(arrayDockState, 1)
&& Состав массива arrayDockState приведен в табл. 6.5
Рис. 6.1. Вложенное прикрепление окон Command и View
Таблица 6.5