Свойства, методы, события, типы, классы______________________1035

Классы TGraphic, TImage, TPicture

Определение

enum TProgressStage {psStarting, psRunning, psEndingb-

typedef void ( closure *TProgressEvent)(System::TObject* Sender,

TProgressStage Stage, Byte PercentDone, bool RedrawNow,
const Windows::TRect &R, const AnsiString Msg);

property TProgressEvent OnProgress

Описание

События OnProgress наступают во время медленных процессов изменения гра-
фического изображения таких, как загрузка, сохранение, трансформация. Эти со-
бытия позволяют построить в приложении индикатор хода процесса, обеспечиваю-
щий обратную связь с пользователем. Разработчики новых компонентов могут ге-
нерировать события OnProgress, вызывая защищенный метод Progress.

Параметр Stage указывает стадию процесса: начало, продолжение, оконча-
ние. Он может соответственно принимать значения psStarting, psRunning и psEn-
ding. Если приложение предусматривает индикацию процесса, то можно создавать
индикатор при Stage == psStarting, изменять его показания, пока Stage = psRun-
ning и закрывать при Stage = psEnding. Параметр PercentDone показывает, какая
примерно часть процесса выполнена. Этот параметр может использоваться в инди-
каторе процесса.

Параметр RedrawNow указывает, может ли изображение в данный момент
быть успешно отображено на экране. Параметр R указывает область изображения,
которая изменена и нуждается в перерисовке.

Параметр Msg содержит краткую справку о протекающем процессе. Напри-
мер, Loading, Storing или Reducing colors. Строка Msg может быть и пустой.

OnStartDrag_______________________________________

Событие наступает, когда пользователь начинает процесс перетаскивания
компонента

Класс TControl

Определение

typedef void ( closure *TStartDragEvent)(System::TObject* Sender,
TDragObject* SDragObject) ;

_property TStartDragEvent OnStartDrag

Описание

Событие OnStartDrag наступает, когда пользователь нажал левую кнопку
мыши над объектом и, не отпуская ее, начал смещать курсор мыши, т.е. начал пе-
ретаскивание.

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

Переменная DragObject по умолчанию равняется NULL. Это означает, что пе-
реноситься будет сам компонент или его объект. При этом автоматически создает-
ся объект типа TDragControlObject, с которым C+4-Builder осуществляет весь про-
цесс перетаскивания. Но обработчик может создавать и новый объект перетаскива-
ния, в котором определен какой-нибудь особый вид курсора и т.п.