JVCL Help:TJvDSADialog

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

Search in JVCL Help

 
Search in all projects
 

Class Hierarchy

TJvDSADialog
run\JvDSADialogs.pas


Summary

Converts a form into a "Don't Show Again" dialog.

run\JvDSADialogs.pas


Pascal

 run\JvDSADialogs.pas
 TJvDSADialog = class(TJvComponent);


Description

  1. JVCLInfo

The TJvDSADialog component converts the form its placed on into a DSA ("Don't Show Again") dialog. The component is basically a link between a VCL form and the included DSA backend.
Converting a dialog into a DSA dialog involves the following tasks:

  • Create and design the form or use an existing form.
  • Drop a control on the form that has both a "Checked" as well as a "Caption" property. A TCheckBox will do fine. There is no need to provide a caption for the check box, as it will be set by theDSA backend when the dialog is shown.
  • Drop a TJvDSADialog component on the form. The component will be the link between the VCL formand the DSA backend. You need to set DialogID to a registered dialog (you can optionally register the dialog in the initialization section of this unit).
  • Use ShowModal to display the form or retrieve the last modal result if the form was previously suppressed.

TJvDSADialog will hook the ShowModal virtual method of the form it is on. This allows the component to check the DSA state and either call the original ShowModal method or just return its result. Note that because the ShowModal method of the form the component is on is being hooked, it doesn't matter if a custom form is used that happens to override the ShowModal method. This overridden method will be called if the dialog is to be displayed.

run\JvDSADialogs.pas


About

Navigation

run\JvDSADialogs.pas



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