XESetPrintErrorValues Extension Function

Purpose

Defines a procedure that is called when an extension error is printed, to print error values.

Library

AIXwindows Library (libXm.a)

C Syntax

void (*XESetPrintErrorValues(DisplayPtr, Extension, Procedure))()
Display *DisplayPtr;
int Extension
void (*Procedure)():

Description

The XESetPrintErrorValues extension function defines a procedure that is called when an extension error is printed, to print error values. Use this function for extension errors that contain additional error values beyond those in a core X error. This function returns any previously defined procedure.

When Xlib needs to print an error, the routine is called with these arguments:

void (*Procedure)(Display, Event, FilePointer)
Display *DisplayPtr;
XErrorEvent *Event;
File *FilePointer;

The structure pointed at by the Event argument is guaranteed to be as large as an XEvent structure, and so can be cast to a type larger than an XErrorEvent, in order to obtain additional values set by using the XESetWireToError extension function. The underlying type of the FilePointer argument depends on the system; on a POSIX-compliant system FilePointer should be cast to type FILE*.

Parameters

Related Information

Using Extensions in AIXwindows in AIX Version 4.3 AIXwindows Programming Guide.

AIXwindows Overview for Programmers in AIX Version 4.3 AIXwindows Programming Guide.