X Property Library Chapter 9
LabWindows/CVI Standard Libraries 9-10 © National Instruments Corporation
Return Values
The return value indicates the success or failure status of the function call. A negative value
indicates an error. The following table shows status values.
NoXErr 0 The function was successful.
InvalidParamXErr -1 NULL was passed to one or more of the parameters.
InvalidPropTypeXErr -5 The propertyType argument is not a valid property type.
This value must either be one of the predefined property
types or be a value returned by CreateXPropType.
DupPropertyXErr -8 A property with the same propertyName, but with
different propertyType already exists.
InsuffMemXErr -19 There is insufficient memory to store the property
information or there are already 256 properties.
Parameter Discussion
propertyType is added with the property the first time you write a property to a window. When
you access a property on a window on which the property already exists, its type must match this
value for the access to succeed.
See Also
Refer to the Xlib Programming Manual or to Xlib—C Language X Interface, MIT X Consortium
Standard for more information about the XInternAtom function.
_____________________________________________________________________________
CreateXPropType
PropLibXErrType status = CreateXPropType (const char *typeName,
unsigned int size, unsigned int unit,
PropTypeHandleX *propertyType);
Purpose
Creates X property type. You can use this function to define the attributes of the properties that
you read and write on X windows. You must create property types with this function before you
can create properties.
Each property type has a unique name and set of attributes that cannot be changed except by
destroying the property and recreating it.