Размещает информацию о доступных в настоящий момент принтерах в массив переменных памяти.

NoteПримечание

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

APRINTERS(ArrayName [, nValue])

Параметры

ArrayName

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

NoteПримечание

Если указанный массив не существует, система Visual FoxPro автоматически создаст массив с указанным именем. Если указанный массив существует, но имеет недостаточный размер для размещения всей необходимой информации, Visual FoxPro увеличит размерность массива до необхлдимых размеров. Если массив имеет больший размер, чем необходимо, Visual FoxPro уменьшит его размеры до необходимой величины. Если массив существует, а доступных принтеров нет, то массив не изменяется, функция APRINTERS( ) вернет значение = 0. Если массив отсутствует, то в этом случае он не будет создан, функция APRINTERS( ) вернет значение = 0.

[, nValue]

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

The following table describes the possible values of nValue.

nValue Описание

0 или отсутствует

Создается массив с (2) двумя столбцами для размещения информации о доступных принтерах:

  • Имя принтера.

  • Имя порта, к которому подсоединен данный принтер.

1

Создается массив с (5) пятью столбцами для размещения информации о доступных принтерах:

  • Имя принтера.

  • Имя порта, к которому подсоединен данный принтер.

  • Имя Драйвера принтера.

  • Комментарий к описанию принтера.

  • Размещение принтера (местоположение).

Expand imageВозвращаемое значение

Числового типа. APRINTERS( ) возвращает количество строк в заданном массиве с информацией, или значение = 0, если принтеры отсутствуют.

Expand imageПример

В следующем примере создается информационный массив с именем gaPrinters, если имеются подсоединенные принтеры (описанные в ОС). В противном случае, выводится сообщение об отсутствии подсоединенных (описанных в ОС) принтерах.

  CopyCode imageКопировать Код
IF APRINTERS(gaPrinters) > 0  
   CLEAR  && clear the current output window
   DISPLAY MEMORY LIKE gaPrinters && show the contents of the array
ELSE  
   WAIT WINDOW 'No printers found.'
ENDIF

Expand imageСм. также