Copyright (C)2000-2009 AI Internet Solutions

Updated April 17, 2009

These configuration options are based on validator messages having a unique "message ID". Not all messages, however, have a message ID. Furthermore, these options are only available in CSE HTML Validator Standard and Professional v5.4930 and above.

First, the message ID of the message is needed. A valid message ID is an integer that is >0 (greater than zero). The message ID can be obtained with a validation results handle (valresults) and code like the following:

// To get the message ID of a message
//  valresults is a handle to the validation results obtained after validating a document
//  i is a zero-based looping variable in a "for" loop that is used to read through the validation messages after a validation (since it is zero-based, add 1 to it when calling CSEGetInteger2EZ())
if (CSEGetInteger3EZ(CSEPROGRAMVERSIONINT)>=54930) { // supported by v5.4930+
 msgid=CSEGetInteger2EZ(valresults, CSERESULTMSGID, i+1); // CSE v5.50+ only
}
else {
 msgid=-1;
}

We recommend that you implement this through the context menu that appears when a user selects a validator message and accesses the context menu for that message. You can then provide options for the user to enable or disable the message, as well as change the message's type (assuming that there is a message ID for the message). If the message's ID is <1 (less than one) then these options should be disabled. If the user is not using a compatible version of the validator, then these messages should always be disabled. Versions that support this functionality will result in this expression being true: (CSEGetInteger3EZ(CSEPROGRAMVERSIONINT)>=54930)

// To find out if the message with a message ID of msgid is enabled
int msgenable=CSEGetInteger2EZ(confighandle, CSECFGMSGENABLE, msgid); // returns 1 if enabled or 0 if not

// To find out if the message's type has been overridden
// msgtype will be one of the following: CSEMSGTYPEERROR, CSEMSGTYPEWARNING, CSEMSGTYPEMESSAGE, CSEMSGTYPECOMMENT, or CSEMSGTYPEDEFAULT
int msgtype=CSEGetInteger2EZ(confighandle, CSECFGMSGTYPE, msgid);

// To disable or enable a message with an ID of msgid
// enables if value is nonzero, disables if value is 0
CSESetInteger2(confighandle, CSECFGMSGENABLE, msgid, value);

// To change a message's type given msgid
// msgtype must be CSEMSGTYPEERROR, CSEMSGTYPEWARNING, CSEMSGTYPEMESSAGE, CSEMSGTYPECOMMENT, or CSEMSGTYPEDEFAULT
CSESetInteger2(confighandle, CSECFGMSGTYPE, msgid, msgtype);

// To display "Quick Help" for the "message ID" feature
CSEDisplayMessage(Handle, CSEDISPLAYMSGMSGIDQUICKHELP, 0);