JVCL Help:TJvProgressDialog.ShowModal

From Project JEDI Wiki
Jump to navigationJump to search
JEDI Visual Component Library Help

Search in JVCL Help

 
Search in all projects
 

Summary

Displays the dialog modally.


Pascal

 functionShowModal: Integer;


Return Value

Returns false if the user canceled the dialog, true otherwise. Users can only cancel the dialog if the ShowCancel property is true.


Description

Call ShowModal when you want to display the dialog modally. When a dialog is displayed modally, you cannot interact with it directly. To update the properties of the dialog, create an event handler for the OnProgress event and perform any necessary updates within it. For example, you can change Min, Max or Position to update the progress bar, Text and Caption to update the visual cues or Image to create a simulation of an animation.
Use ShowModal when the process is performed in its own thread or when the process is suitable to be performed in short intervals (like attempting to connect to a service). If the process is time-intensive and executed within the main thread, consider using Show instead.


See Also

TJvProgressDialog.Caption, TJvProgressDialog.Image, TJvProgressDialog.Max, TJvProgressDialog.Min, TJvProgressDialog.Position, TJvProgressDialog.Show, TJvProgressDialog.Text


About

Contribute to this help topic

This documentation wiki is based on the collaborative effort of Project JEDI users. Your edits are welcome in order to improve documentation quality: edit this page