XtAppSetTypeConverter (3)

Leading comments

Copyright (c) 1993, 1994  X Consortium

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software furnished to do so, subject to the following conditions:

The above copyright notice...

(The comments found at the beginning of the groff file "man3/XtAppSetTypeConverter.3".)

NAME

XtAppSetTypeConverter, XtSetTypeConverter - register resource converter

SYNTAX

void XtAppSetTypeConverter(XtAppContext app_context, String from_type, String to_type, XtConverter converter, XtConvertArgList convert_args, Cardinal num_args, XtCacheType cache_type, XtDestructor destructor);

void XtSetTypeConverter(String from_type, String to_type, XtConverter converter, XtConvertArgList convert_args, Cardinal num_args, XtCacheType cache_type, XtDestructor destructor);

ARGUMENTS

app_context

Specifies the application context.

converter

Specifies the type converter procedure.

convert_args

Specifies how to compute the additional arguments to the converter or NULL.

from_type

Specifies the source type.

num_args

Specifies the number of additional arguments to the converter or zero.

to_type

Specifies the destination type.

cache_type

Specifies whether or not resources produced by this converter are sharable or display-specific and when they should be freed.

destructor

Specifies a destroy procedure for resources produced by this conversion, or NULL if no additional action is required to deallocate resources produced by the converter.

DESCRIPTION

XtSetTypeConverter registers the specified type converter and destructor in all application contexts created by the calling process, including any future application contexts that may be created. XtAppSetTypeConverter registers the specified type converter in the single application context specified. If the same from_type and to_type are specified in multiple calls to either function, the most recent overrides the previous ones.

SEE ALSO

X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface