onInactiveElementMessage()

onInactiveElementMessage()

This function is called when an element is found in the configuration but its category is not active and a validator error message is about to be generated. This function can be used to ignore certain elements and/or to change or display additional messages when certain inactive elements are used; the following variables are defined when this function is called and may be modified before the validator message is displayed: (New v12.0030)

$oiem_element - the name of the unknown element

$oiem_msgtext - the message text of the validator message that will be generated

$oiem_msgtextappend - an additional message that is appended to the end of $oiem_msgtext; the default is " Did you misspell it?"

$oiem_msgtextprepend - an additional message that is prepended to the front of $oiem_msgtext; the default is an empty string (New v8.0100)

$oiem_msgcat - the message category of the validator message that will be generated; the default is "" for no category

$oiem_msgflags - the message flags value used when calling MessageEx() to generate the message; set to 0 to cancel the message

$oiem_msgid - the message ID of the validator message that will be generated; the default is -1 for no message ID

$oiem_msgtype - the message type of the validator message that will be generated; the default is $MSG_ERROR

For unknown elements use onUnknownElementMessage().