Message[Ex]() (Validator Engine Only)

Contents

int Message(int $display, int $messagetype, string $message[, location exp $location]);

•$display - if nonzero, then the message is displayed; if zero (0), then the message is not displayed

•$messagetype - the type of message to display

•MSGBOX_INFORMATION - displays a standard windows information dialog box on the display

•MSGBOX_ERROR - displays a standard windows error dialog box on the display

•MSGBOX_WARNING - displays a standard windows warning dialog box on the display

•MSGBOX_YESNOQUESTION - displays a standard windows question dialog box on the display with 'Yes' and 'No' buttons; returns 1 if the user answers 'Yes' or returns 0 if the user answers 'No'

•MSG_ERROR - adds an error message to the message output of the validator

•MSG_WARNING - adds a warning message to the message output of the validator

•MSG_COMMENT - adds a comment message to the message output of the validator

•MSG_MESSAGE - adds a general message to the message output of the validator

•$message - the actual message text to display

•$location - (OPTIONAL) points to the location in the html document that caused the message to be generated; the default is the first character of the tag name; this parameter is not used if $messagetype is MSGBOX_*.

•Return value - see the return value for MessageEx();

•Do not use the optional location argument if using a MSGBOX_* message type.

•Start validation and end validation programs may only display comment type messages.

int MessageEx(int $flags[, int $msgid (use flag 4)], int $messagetype[, string $category (see flag 8)], string $message[, location exp $location]);

•$flags

•1 - if set, then the message is displayed; if not set, then the message is not displayed

•2 - message is a style message to be displayed in the Styles tab of the integrated editor (New v4.9920)

•4 - following the $flags parameter is an integer which is the message's unique ID number (New v5.4930)

•8 - message has no category; do not supply the $category parameter (New v5.4930)

•16 - message is an accessibility message to be displayed in the Accessibility tab of the integrated editor (New v5.9910)

•32 - message is a WCAG 1.0 "priority 1/conformance level A" accessibility message (automatically sets flag 16) to be displayed in the Accessibility tab of the integrated editor (New v5.9930)

•64 - message is a WCAG 1.0 "priority 2/conformance level AA" accessibility message (automatically sets flag 16) to be displayed in the Accessibility tab of the integrated editor (New v5.9930)

•128 - message is a WCAG 1.0 "priority 3/conformance level AAA" accessibility message (automatically sets flag 16) to be displayed in the Accessibility tab of the integrated editor (New v5.9930)

•256 - if in standards compliant mode then upgrade $messagetype to MSG_ERROR (New v6.5020)

•512 - message was generated by HTML Tidy (New v6.9941)

•1024 - display message, overriding virtually any option or situation that would normally disable it (flag 1 must still be set to display the message) (New v7.0000)

•2048 - message generated by nsgmls; internal use only - do not use (New v8.00)

•4096 - message generated by PHP syntax checker; internal use only - do not use (New v8.9910)

•8192 - for comment (MSG_COMMENT) messages - place the message at the top of all comment messages; doesn't do anything for other message types (New v8.9930)

•16384 (0x4000) - put message at the very top (New v8.9940)

•32768 (0x8000) - message is a WCAG 2.0 conformance level "A" accessibility message (automatically sets flag 16) to be displayed in the Accessibility tab of the integrated editor (New v9.9912)

•65536 (0x10000) - message is a WCAG 2.0 conformance level "AA" accessibility message (automatically sets flag 16) to be displayed in the Accessibility tab of the integrated editor (New v9.9912)

•131072 (0x20000) - message is a WCAG 2.0 conformance level "AAA" accessibility message (automatically sets flag 16) to be displayed in the Accessibility tab of the integrated editor (New v9.9912)

•262144 (0x40000) - if in standards compliant mode then upgrade $messagetype (if not an error) to MSG_WARNING (New v9.9931)

•524288 (0x80000) - message was generated by the JavaScript linter (New v10.0032)

•0x100000 - keyword density message (internal use only) (New v10.0047)

•0x200000 - message generated by the XML parser; internal use only - do not use (New v10.9914)

•0x400000 - message generated by JSLint; internal use only - do not use (New v10.9914)

•0x800000 - if accessibility checking and WCAG 2.0 checking are both enabled, then also generate a WCAG 2.0 error message; use with messages about parsing problems that may cause inconsistent presentations or interpretations of the page (New v11.0111)

•NOTE: Use only zero or one of these flags: 32, 64, 128, 32768, 65536, 131072

•$msgid - a unique number (no two messages should have the same $msgid number) so that the message can be individually disabled or its message type changed using the message ID feature; flag 4 must be used if supplying a $msgid (New v5.4930)