Интерфейс IOutputLocation используется для управления папкой, в которой размещаются выходные файлы, а также именами последних.
Свойства
String FileName
Свойство определяет имя выходного файла. Доступно для чтения и записи. Возможно использование макросов:
Макрос
Описание
Пример значения
&[DocName(0)]
Имя документа
My Document
&[DocName(1)]
Имя документа, написанное символами в верхнем регистре
MY DOCUMENT
&[DocName(2)]
Имя документа, написанное символами в нижнем регистре
my document
&[Page(0)]
Номер страницы
3
&[Page(2)] . . . &[Page(6)]
Номер страницы с числом цифр от 2 до 6
05
000005
&[ImageType]
Стандартное расширение для выбранного формата выходного файла
2pdf
&[ColorDepth]
Число, обозначающее глубину цвета выходного изображения
24
&[Year(0)]
Текущий год в полном формате
2009
&[Year(1)]
Текущий год в двухсимвольном формате
09
&[Month(0)]
Текущий месяц в текстовом формате
February
&[Month(1)]
Текущий месяц в виде арабских цифр
02
&[Month(2)]
Текущий месяц в виде латинских цифр
II
&[MonthDay(0)]
Текущее число
3
&[MonthDay(1)]
Текущее число в двухсимвольном формате
03
&[WeekDay(0)]
Текущий день недели в текстовом формате
Tuesday
&[WeekDay(1)]
Текущий день недели в числовом формате
3
&[WeekDay(2)]
Текущий день недели в числовом двухсимвольном формате
03
&[Date(0)]
Полная текущая дата
Tuesday, February 03, 2009
&[Date(1)]
Текущая дата в формате dd.mm.yyyy
03.02.2009
&[Date(2)]
Текущая дата в формате dd.mm.yy
03.02.09
&[Hour(0)]
Текущий час в 24-часовом формате
21
&[Hour(1)]
Текущий час в 12-часовом формате
09
&[Hour(2)]
AM или PM
am
&[Min(0)]
Текущее время, минуты
31
&[Sec(0)]
Текущее время, секунды
38
&[Time(0)]
Текущее время в формате hh-mm-ss
09-31-38
&[Time(1)]
Текущее время в формате hh-mm (24-часовой формат)
21-31
&[Time(2)]
Текущее время в формате hh-mm (12-часовой формат)
09-31
String FolderPath
Свойство определяет папку, в которой будут сохраняться выходные файлы. Для указания выходной папки могут использоваться как статичные строки, так и макросы, которые в процессе выполнения будут автоматически заменяться реальными значениями. Свойство актуально только в том случае, если свойство Mode имеет значение OL_PREDEFINED. Доступно для чтения и записи.
Макрос
Описание
Пример значения
&[Desktop]
Рабочий стол текущего пользователя
C:\Documents and Settings\User\Рабочий стол
&[Documents]
Папка "Мои документы" текущего пользователя
C:\Мои документы
&[Pictures]
Папка "Мои рисунки" текущего пользователя
C:\Мои документы\Мои рисунки
Enum Mode
Свойство определяет способ получения программой имен выходных файлов и папок, в которых они будут размещаться. Доступно для чтения и записи.
Константа
Значение
Описание
LM_PROMPT
0
Режим работы, при котором при создании каждого выходного файла на экран будет выдаваться стандартный диалог Windows, позволяющий задачть папку и имя файла вручную
LM_PREDEFINED
1
Имена выходных файлов и папки, в которых они размещаются, определяются автоматически в соответствии со значениями свойств FileName и FolderPath
Boolean OverwriteExistingFile
Свойство определяет, будет или нет программа перезаписывать существующий файл, если его имя совпадает с именем создаваемого. Значение этого свойства игнорируется, если свойство Multipage интерфейса, соответствующего формату выходного файла, имеет значение MM_APPEND. Доступно для чтения и записи.
Значение
Описание
TRUE
При сохранении выходных файлов программа будет автоматически перезаписывать существующие файлы с совпадающими именами.
FALSE
В том случае, если при сохранении выходного файла будет найден файл с таким же именем, на экран будет выдан запрос о дальнейших действиях.
Примеры использования
Язык Visual Basic 6
Dim objUDC As IUDC
Dim itfPrinter As IUDCPrinter
Dim itfProfile As IProfile
Set objUDC = New UDC.APIWrapper
Set itfPrinter = objUDC.Printers("Universal Document Converter")
Set itfProfile = itfPrinter.Profile
itfProfile.OutputLocation.Mode = LM_PREDEFINED
itfProfile.OutputLocation.FolderPath = "C:\Out"
itfProfile.OutputLocation.FileName = "&[Date(1)]-&[DocName(0)].&[ImageType]"
itfProfile.OutputLocation.OverwriteExistingFile = False
