Property Map

This topic outlines the mapping of the TaskDialog API parameters and record fields to the LMD DialogPack equivalents.

While JSDialog is a dialog that can emulate the behaviour of the new Windows Vista only TaskDialog and TaskDialogIndirect API calls it also does many things the API does not support. This is why the number of properties the component has, may be a little daunting at first.

While the component editor is a great way to reduce this daunting feeling, it is only available to registered users of the component.

To help get you started here is breakdown of the TaskDialog properties and their equivalent TJSDialog properties.

TaskDialog

TaskDialog	TJSDialog Component
hwndParent	Dialog owner passed in Execute overload
hInstance	Not required
pszWindowTitle	Title
pszMainInstruction	Instruction.Text
pszContent	Content
dwCommonButtons	ButtonBar.CommonButtons
hMainIcon	MainIcon

TaskDialogIndirect

TaskDialogIndirect	TJSDialog Component
hwndParent	Dialog owner passed in Execute overload
hInstance	Not required
pszWindowTitle	Title
pszMainInstruction	Instruction.Text
pszContent	Content
dwCommonButtons	ButtonBar.CommonButtons
hMainIcon	MainIcon
dwFlags	DialogOptions
cButtons	CustomButtons
pButtons	CustomButtons
nDefaultButton	ButtonBar.CommonButtons.Default CustomButtons[index].Default
cRadioButtons	RadioButtons
pRadioButtons	RadioButtons
nDefaultRadioButton	RadioButtons[Index].Checked
pszVerificationText	Verification.Text
pszExpandedInformation	Expando.Lines
pszExpandedControlText	Expando.Expanded
pszCollapsedControlText	Expando.Collapsed
hFooterIcon	Footer.Icon
pszFooterIcon	Footer.Icon
pszFooter	Footer.Text
pfCallback	Published events
lpCallbackData	Published events
cxWidth	Width

A TJSDialog component can be dropped on a form or instantiated in code, there are also a number of predefined wrapper functions to make using the dialog more convenient to use.

See the Wrapper Functions topic for detailed information on the included wrapper functions.

What do you think about this topic? Send feedback!