Правильная ссылка на эту страницу
http://az-design.ru/Support/SoftWare/Delphi/D3/SB34.shtml

Глава 34. TCommonDialog и его производные

  • TCommonDialog
  • TColorDialog
  • TFindDialog
  • TFontDialog
  • TOpenDialog
  • Filter Editor
  • TPrintDialog
  • TPrinterSetupDialog
  • TReplaceDialog
  • TSaveDialog

       Одно из конструктивных достижений Windows заключается в том, что она предлагает стандартизованный интерфейс, на который пользователь может вполне положиться. Меню и линейки инструментов в прикладных программах достаточно похожи, так что пользователь не путается и не вынужден изучать новый набор интерфейсных соглашений в каждом новом приложении. Еще одной областью стандартизации в Windows является использование общих диалоговых окон — множества диалоговых окон, поддерживаемых непосредственно операционной системой и доступных любому приложению. Когда пользовательский интерфейс Windows изменился с Windows NT 3.x на оболочку Explorer, использованную в Windows 95 и Windows NT 4.0, общие диалоговые окна были усовершенствованы для обработки длинных имен файлов и предложены дополнительные усовершенствования по сравнению со своими устаревшими предшественниками. Применяя общие диалоговые окна Windows не приходится изобретать колесо и можно предложить пользователям именно тот последовательный, стандартизованный интерфейс, который они ожидают. Delphi инкапсулирует общие диалоговые окна Windows в абстрактном классе TCommonDialog и его производных.

TCommonDialog
       TCommonDialog является абстрактным базовым классом для реализации в Delphi общих диалоговых окон Windows. Общие диалоги Delphi являются компонентами, которые непосредственно представляют стандартные общие диалоги Windows, доступные для всех разработчиков приложений.
       TCommonDialog обеспечивает базовую функциональность всех общих диалоговых окон. Вам обычно не придется порождать от TCommonDialog новые потомки, поскольку он сконструирован специально для инкапсуляции общих диалоговых окон Windows, а не диалоговых окон вообще. Разработчики, желающие создать специальные диалоговые окна, должны использовать стандартные формы Delphi.
       Рисунок 34-1 показывает ветвь TCommonDialog VCL. В таблице 34-1 перечислены свойства и методы, реализуемые TCommonDialog.


РИСУНОК 34-1 Ветвь TCommonDialog VCL

Таблица 34-1 Методы, свойства и события, реализуемые TCommonDialog

Использовать или установить это ... Чтобы сделать это ... Наследование
Assign Присвоить один устойчивый объект другому. TPersistent
ClassName Получить имя класса объекта. TObject
ClassParent Получить родительский класс объекта. TObject
ClassType Получить действительный тип объекта. TObject
ComponentCount Определить количество компонентов, находящихся во владении. TComponent
ComponentIndex Определить индекс компонента в списке Components владельца. TComponent
Components Определить список компонентов, находящихся во владении. TComponent
ComponentState Определить состояние компонента. TComponent
Create Создать новый компонент. TObject
Ctl3D Отобразить диалоговое окно с эффектом 3D или 2D. Нет
Destroy Разрушить компонент. TObject
DestroyComponents Разрушить все компоненты, принадлежащие данному. TComponent
Destroying Уведомить компонент о предстоящем разрушении. TComponent
FindComponent Найти компонент в массивном списке Components. TComponent
Free Безопасно разрушить объект. TObject
HelpContext Определить номер идентификатора контекста Help для диалогового окна Нет
InheritsFrom Определить, происходит ли объект от определенного класса. TObject
InstanceSize Определить объем памяти, распределенной под объект. TObject
Name Определить имя компонента. TComponent
Owner Определить владельца компонента. TComponent
Tag Сохранить вместе с компонентом дополнительное целое значение. TComponent

TColorDialog
       Класс TColorDialog инкапсулирует диалоговое окно Color, показанное на рисунке 34-2.


РИСУНОК 34-2 Диалоговое окно Color

       Диалоговое окно Color предоставляет возможность выбора цвета из палитры цветов. Диалоговое окно можно использовать для установки цвета любого компонента, у которого имеется свойство Color.
       В таблице 34-2 перечислены свойства и методы, реализуемые TColorDialog. Они дополняют свойства и методы, унаследованные от TCommonDialog (обратитесь к таблице 34-1).

Таблица 34-2 Методы и свойства, реализуемые TColorDialog

Использовать или установить это ... Чтобы сделать это ... Наследование
Color Получить цвет, возвращаемый диалоговым окном Color. Нет
Create Создать новое диалоговое окно Color. TObject
Ctl3D Отобразить диалоговое окно Color с эффектом 3D или 2D. TCommonDialog
CustomColors Определить, отображается ли раздел цветов Custom. Нет
Destroy Разрушить диалоговое окно Color. TObject
Execute Открыть диалоговое окно Color. Нет
Options Определить опции, доступные для диалогового окна Color. Нет

TFindDialog
       Класс TFindDialog создает стандартное диалоговое окно Find, использующееся для поиска текста в файле У диалога Find есть свойство FindText, которое содержит искомый текст, и этот диалог может обрабатывать события, происходящие во время поиска текста, с помощью события OnFind (см.рис 34-3)


РИСУНОК 34-3 Диалоговое окно Find

       Описанный ниже TReplaceDialog является прямым потомком TFindDialog и, следовательно, наследует все свойства и методы, реализуемые TFindDialog, показанные в таблице 34-3 Они являются дополнением к унаследованным от TCommonDialog (обратитесь к таблице 34-1)

Таблица 34-3 Методы, свойства и события, реализуемые TFindDialog и TReplaceDialog

Использовать или установить это ... Чтобы сделать это ... Наследование
Create Создать новое диалоговое окно Find или Replace TObject
Destroy Разрушить диалоговое окно Find или Replace TObject
Execute Открыть диалоговое окно Find или Replace Нет
FindText Определить текст, который пользователь пытается найти или заменить Нет
Handle Получить дескриптор Windows для диалогового окна Нет
Left Определить координату х позиции, где появляется диалоговое окно Нет
OnFind Обработать событие, которое происходит, когда текст найден Нет
Options Определить, какие опции доступны диалоговому окну Нет
Position Определить позицию, где появляется диалоговое окно Нет
Top Определить координату у позиции, где появляется диалоговое окно Нет

TFontDialog
       Класс TFontDialog инкапсулирует диалоговые окна Font Диалоговые окна Font предоставляют возможность выбора шрифта и установки стиля шрифта Шрифт, выбранный пользователем, содержится в свойстве Font Диалоговое окно Font представлено на рисунке 34-4
       Диалоговое окно Font можно использовать для установки шрифта для любого компонента, который имеет свойство Font
       В таблице 34-4 перечислены свойства, методы и события, реализуемые TFontDialog Они являются дополнением к свойствам и методам, унаследованным от TCommonDialog (обратитесь к таблице 34-1)


РИСУНОК 34-4 Диалоговое окно Font

Таблица 34-4 Методы, свойства и события, реализуемые TFontDialog

Использовать или установить это ... Чтобы сделать это ... Наследование
Create Создать новое диалоговое окно Font TObject
Destroy Разрушить диалоговое окно Font TObject
Device Определить, на какое устройство будет влиять возвращаемый шрифт Нет
Execute Открыть диалоговое окно Font Нет
Font Определить, какой шрифт был возвращен диалоговым окном Font Нет
MaxFontSize Установить максимальный размер шрифта, допустимый в диалоговом окне Font Нет
MinFontSize Установить минимальный размер шрифта, допустимый в диалоговом окне Font Нет
OnApply Обработать событие, которое происходит при нажатии кнопки Apply

Нет

Options Определить, какие опции доступны для диалогового окна Font Нет

TOpenDialog
       Диалоговое окно Open предоставляет возможность указать файл в пространстве имен Windows, который следует открыть. Выбранное имя файла содержится в свойстве FileName. Класс TOpenDialog инкапсулирует диалоговое окно Open Windows, представленное на рисунке 34-5.


РИСУНОК 34-5 Диалоговое окно Open

Filter Editor
       Delphi IDE включает Filter Editor, который предоставляет возможность определения фильтров для диалоговых окон Open и Save. Фильтр — это множество спецификаций имен файлов, которые определяют, какие типы файлов будет показывать диалог. Например, при выборе Open из меню File в Delphi IDE, возникающее диалоговое окно Open использует фильтр по умолчанию. Отбираются файлы *.pas и *.dpr.
       Filter Editor, представленный на рисунке 34-6, доступен после двойного щелчка на поле свойства Filter в Object Inspector, когда выбран диалог Open или диалог Save. Подробности смотрите при описании свойства Filter.
       Описанный ниже TSaveDialog является прямым потомком TOpenDialog и, следовательно, наследует все свойства и методы, реализуемые TOpenDialog. Эти свойства и методы приведены в таблице 34-5. Они являются дополнением к свойствам и методам, унаследованным от TCommonDialog (обратитесь к таблице 34-1).


РИСУНОК 34-6 Filter Editor

Таблица 34-5 Методы и свойства, реализуемые TOpenDialog и TSaveDialog

Использовать или установить это ... Чтобы сделать это ... Наследование
Create Создать новое диалоговое окно Open или Save TObject
DefaultExt Определить расширение по умолчанию для файлов в диалоговом окне Нет
Destroy Разрушить диалоговое окно Open или Save TObject
Execute Открыть диалоговое окно Open или Save Нет
FileName Определить имя файла, возвращенное диалоговым окном Нет
Files Определить файлы, возвращенные диалоговым окном с множественным выбором Нет
Filter Определить фильтр или фильтры для использования диалоговым окном Нет
FilterIndex Определить фильтр по умолчанию, который будет использоваться при открытии диалогового окна Нет
InitialDir Определить каталог, отображаемый в диалоговом окне при открытии Нет
Options Определить, какие опции доступны для диалогового окна Нет
Title Определить заголовок на линейке заголовка диалогового окна Нет

TPrintDialog
       TPrintDialog инкапсулирует стандартное диалоговое окно Print, которое показано на рисунке 34-7 Диалоговое окно Print предоставляет возможность распечатывания документа и задания параметров, подобных принтеру и количеству выводимых копий Диалоговое окно Print включает также кнопку Setup, которая при нажатии открывает диалог Printer Setup, инкапсулированный в TPrinterSetupDialog.
       Таблица 34-6 отображает свойства и методы, реализуемые TPrintDialog Они являются дополнением к свойствам и методам, унаследованным от TCommonDialog (обратитесь к таблице 34-1).

Таблица 34-6 Методы и свойства, реализуемые TPrintDialog

Использовать или установить это ... Чтобы сделать это ... Наследование
Collate Определить, будут ли разбираться печатные копии Нет
Copies Определить количество печатаемых копий Нет
Execute Открыть диалоговое окно Print Нет
FromPage Определить часть "от" диапазона печати Нет
MaxPage Определить максимальный номер страницы, который разрешено печатать Нет
MinPage Определить минимальный номер страницы, который разрешено печатать Нет
Options Определить, какие опции доступны диалоговому окну Print Нет
PrintRange Определить тип диапазона печати, используемый для печати файла Нет
PrintToFile Определить, куда будет выводиться печать - на принтер или в файл Нет
ToPage Определить часть "до" диапазона печати Нет


РИСУНОК 34-7 Диалоговое окно Print

TPrinterSetupDialog
       Диалог Printer Setup вызывается при нажатии кнопки Setup в диалоговом окне Print Диалог Printer Setup инкапсулирован в классе TPrinterSetupDialog и предоставляет возможность установки свойств принтера, определения макета печатных страниц и размера бумаги и источника Диалоговое окно Printer Setup показано на рисунке 34-8


РИСУНОК 34-8 Диалоговое окно Printer Setup

       Иметь компонент диалогового окна Printer Setup в форме для использования в программе не требуется При щелчке на кнопке Setup в диалоговом окне Print Delphi создает диалоговое окно Printer Setup автоматически Поскольку данное диалоговое окно взаимодействует с системой на низком уровне, реализовывать какие-то программы поддержки необязательно Единственный метод, которые можно выполнить непосредственно — это метод Execute, открывающий диалоговое окно
       В таблице 34-7 перечислены методы, реализуемые TPrinterSetupDialog Они являются дополнением к свойствам и методам, унаследованным от TCommonDialog (обратитесь к таблице 34-1)

Таблица 34-7 Методы, реализуемые TPrinterSetupDialog

Использовать или установить это ... Чтобы сделать это ... Наследование
Execute Открыть диалоговое окно Printer Setup Нет

TReplaceDialog
       Диалоговое окно Replace, показанное на рисунке 34-9, предоставляет возможность осуществления замены текста в указанной строке Свойство ReplaceText содержит текст, который заменяет указанный Диалоговое окно Replace инкапсулируется классом TReplaceDialog.

Примечание
       TReplaceDialog является прямым потомком TFindDialog, поэтому свойства и методы, используемые в TFindDialog применимы и к TReplaceDialog.


РИСУНОК 34-9 Диалоговое окно Replace

В таблице 34-8 перечислены свойства, методы и события, реализуемые TReplaceDialog Они являются дополнением к свойствам и методам, унаследованным от TCommonDialog (обратитесь к таблице 34-1) и TFindDialog (обратитесь к таблице 34-3)

Таблица 34-8 Методы, свойства и события, реализуемые TReplaceDialog

Использовать или установить это ... Чтобы сделать это ... Наследование
Create Создать диалоговое окно Replace TObject
OnReplace Обработать событие, которое происходит в момент замены текста Нет
ReplaceText Текст, который заменяет текст из FindText Нет

TSaveDialog
       Диалоговое окно Save As инкапсулируется TSaveDialog и предоставляет возможность сохранения файла на диске. Диалоговое окно Save As показано на рисунке 34-10.


РИСУНОК 34-10 Диалоговое окно Save As

       Для диалогового окна Save As можно указать filter, как было описано при освещении TOpenDialog ранее, и при описании свойства Filter позже в главе.

Примечание
       TSaveDialog является прямым потомком TOpenDialog, поэтому свойства и методы TOpenDialog применимы и к TSaveDialog.

       В таблице 34-9 перечислены методы, реализуемые TSaveDialog Они являются дополнением к методам и свойствам, унаследованным от TCommonDialog (обратитесь к таблице 34-1)

Таблица 34-9 Метод, реализуемый TSaveDialog

Использовать или установить это ... Чтобы сделать это ... Наследование
Execute Открыть диалоговое окно Save Нет

Свойство Collate
Свойство Color
Свойство Copies
Свойство Ctl3D
Свойство CustomColors
Свойство DefaultExt
Свойство Device
Метод Execute
Свойство FileName
Свойство Files
Свойство Filter
Свойство FilterIndex
Свойство FindText
Свойство Font
Свойство FromPage
Свойство Handle
Свойство HelpContext
Свойство InitialDir
Свойство Left
Свойство MaxFontSize
Свойство MaxPage
Свойство MinFontSize
Свойство MinPage
Событие OnApply
Событие OnFind
Событие OnReplace
Свойство Options
Свойство Position
Свойство PrintRange
Свойство PrintToFile
Свойство ReplaceText
Свойство Title
Свойство ToPage

уже скачали 124 раз.


<<< Пред. Оглавление
Начало раздела
След. >>>




Дата последнего изменения:
Thursday, 21-Aug-2014 09:10:56 MSK


Постоянный адрес статьи:
http://az-design.ru/Support/SoftWare/Delphi/D3/SB34.shtml