Tk Source Code: Diff

Differences From Artifact [1fcce11b]:

File doc/SetOptions.3 — part of check-in [ec369c24] at 2000-09-29 17:55:30 on branch trunk — * generic/tkTest.c: Fixed tests to use updated API.
* doc/SetOptions.3: * generic/tk.h: * generic/tkConfig.c: Changed interface for Tk_CustomOptionSetProc and Tk_CustomOptionGetProc; these now take a pointer to the start of the widget record, and an integer offset to the slot for the option value, instead of just a pointer to the slot. This allows more sophisticated options to do interesting things based on other data in the widget record. (user: ericm size: 32369)

To Artifact [5ffdaea8]:

File doc/SetOptions.3 — part of check-in [60320254] at 2000-10-01 21:31:35 on branch trunk — * doc/SetOptions.3: Added note that restoreProc and freeProc may be NULL.
* generic/tkConfig.c (Tk_RestoreSavedOptions): For custom options, added test that the restoreProc is not NULL, to allow for custom options that don't care about supporting Tk_RestoreSavedOptions. (user: ericm size: 32487)

1 2 3 4 5 6 7 8 9 10 11 12 13 14	1 2 3 4 5 6 7 8 9 10 11 12 13 14	- +	'\" '\" Copyright (c) 1998 Sun Microsystems, Inc. '\" '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" ~~'\" RCS: @(#) $Id: SetOptions.3,v 1.7 2000/09/~~29 17:55~~:30 ericm Exp $~~ '\" RCS: @(#) $Id: SetOptions.3,v 1.8 2000/10/01 21:31:35 ericm Exp $ '\" .so man.macros .TH Tk_SetOptions 3 8.1 Tk "Tk Library Procedures" .BS .SH NAME Tk_CreateOptionTable, Tk_DeleteOptionTable, Tk_InitOptions, Tk_SetOptions, Tk_FreeSavedOptions, Tk_RestoreSavedOptions, Tk_GetOptionValue, Tk_GetOptionInfo, Tk_FreeConfigOptions, Tk_Offset \- process configuration options .SH SYNOPSIS
︙
551 552 553 554 555 556 557 ~~558~~ 559 560 561 562 563 564 565	551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567	- + + +	.CE .PP The Tk_ObjCustomOption structure contains six fields: a name for the custom option type; pointers to the four procedures; and a \fIclientData\fR value to be passed to those procedures when they are invoked. The \fIclientData\fR value typically points to a structure containing information that is needed by the procedures when they are ~~parsing and printing options.~~ parsing and printing options. \fIRestoreProc\fR and \fIfreeProc\fR may be NULL, indicating that no function should be called for those operations. .PP The \fIsetProc\fR procedure is invoked by \fBTk_SetOptions\fR to convert a Tcl_Obj into an internal representation and store the resulting value in the widget record. The arguments are: .RS .TP \fIclientData\fR
︙