Thanks you both for your comments.
I have developed a bit further.
If I place the following code in the DocReady event of a button on the form, the message is displayed but the document loads and displays as it normally would.
However, if I copy & paste the same code into the Click event of the same button, when I click the button, the message is displayed, IE opens and the Acrobat Reader download page is displayed, and the document (but not Acrobat Reader) closes, which is precisely the behaviour I am seeking.
So the question is now: why does it not work from the DocReady event?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
//check version of Acrobat
var appVer = app.viewerVersion;
if (appVer < 7) { var viewerMsg =
"You are currently using Acrobat Reader version " + appVer + " .\n\n"
+ "This PDF document requires Acrobat Reader version 7.0 or later.\n\n"
+ "---------------------------------------------------------------------------------------\n\n"
+ "Please download and install the lastest version of Acrobat Reader from:\n\n"
+ "http://www.adobe.com/products/acrobat/readstep2.html";
xfa.host.messageBox(viewerMsg);
xfa.host.gotoURL("http://www.adobe.com/products/acrobat/readstep2.html");
app.execMenuItem("Close");
}