Linux Manuals session 3

Tk_CreateWindow, Tk_CreateWindowFromPath, Tk_DestroyWindow, Tk_MakeWindowExist – create or delete window Synopsis#include <tk.h> Tk_Window Tk_CreateWindow(interp, parent, name, topLevScreen) Tk_Window Tk_CreateAnonymousWindow(interp, parent, topLevScreen) Tk_Window Tk_CreateWindowFromPath(interp, tkwin, pathName, topLevScreen) Tk_DestroyWindow(tkwin) Tk_MakeWindowExist(tkwin)ArgumentsTcl_Interp *interp (out) Tcl interpreter to use for error reporting. If no error occurs, then *interp is not modified. Tk_Window parent (in) Token for the window that is to…

Tk_CreateSelHandler, Tk_DeleteSelHandler – arrange to handle requests for a selection Synopsis#include <tk.h> Tk_CreateSelHandler(tkwin, selection, target, proc, clientData, format) Tk_DeleteSelHandler(tkwin, selection, target)ArgumentsTk_Window tkwin (in) Window for which proc will provide selection information. Atom selection (in) The name of the selection for which proc will provide selection information. Atom target (in) Form in which proc can provide…

Tk_CreatePhotoImageFormat – define new file format for photo images Synopsis#include <tk.h> Tk_CreatePhotoImageFormat(formatPtr)ArgumentsTk_PhotoImageFormat *formatPtr (in) Structure that defines the new file format. DescriptionTk_CreatePhotoImageFormat is invoked to define a new file format for image data for use with photo images. The code that implements an image file format is called an image file format handler, or handler…

Tk_CreateOptionTable, Tk_DeleteOptionTable, Tk_InitOptions, Tk_SetOptions, Tk_FreeSavedOptions, Tk_RestoreSavedOptions, Tk_GetOptionValue, Tk_GetOptionInfo, Tk_FreeConfigOptions, Tk_Offset – process configuration options Synopsis#include <tk.h> Tk_OptionTable Tk_CreateOptionTable(interp, templatePtr) Tk_DeleteOptionTable(optionTable) int Tk_InitOptions(interp, recordPtr, optionTable, tkwin) int Tk_SetOptions(interp, recordPtr, optionTable, objc, objv, tkwin, savePtr, maskPtr) Tk_FreeSavedOptions(savedPtr) Tk_RestoreSavedOptions(savedPtr) Tcl_Obj * Tk_GetOptionValue(interp, recordPtr, optionTable, namePtr, tkwin) Tcl_Obj * Tk_GetOptionInfo(interp, recordPtr, optionTable, namePtr, tkwin) Tk_FreeConfigOptions(recordPtr, optionTable, tkwin) int Tk_Offset(type,…

Tk_CreateItemType, Tk_GetItemTypes – define new kind of canvas item Synopsis#include <tk.h> Tk_CreateItemType(typePtr) Tk_ItemType * Tk_GetItemTypes()ArgumentsTk_ItemType *typePtr (in) Structure that defines the new type of canvas item. IntroductionTk_CreateItemType is invoked to define a new kind of canvas item described by the typePtr argument. An item type corresponds to a particular value of the type argument to…

Tk_CreateImageType, Tk_GetImageMasterData, Tk_InitImageArgs – define new kind of image Synopsis#include <tk.h> Tk_CreateImageType(typePtr) ClientData Tk_GetImageMasterData(interp, name, typePtrPtr) Tk_InitImageArgs(interp, argc, argvPtr)ArgumentsTk_ImageType *typePtr (in) Structure that defines the new type of image. Must be static: a pointer to this structure is retained by the image code. Tcl_Interp *interp (in) Interpreter in which image was created. const char *name…

Tk_CreateGenericHandler, Tk_DeleteGenericHandler – associate procedure callback with all X events Synopsis#include <tk.h> Tk_CreateGenericHandler(proc, clientData) Tk_DeleteGenericHandler(proc, clientData)ArgumentsTk_GenericProc *proc (in) Procedure to invoke whenever any X event occurs on any display. ClientData clientData (in) Arbitrary one-word value to pass to proc. DescriptionTk_CreateGenericHandler arranges for proc to be invoked in the future whenever any X event occurs. This…

Tk_CreateEventHandler, Tk_DeleteEventHandler – associate procedure callback with an X event Synopsis#include <tk.h> Tk_CreateEventHandler(tkwin, mask, proc, clientData) Tk_DeleteEventHandler(tkwin, mask, proc, clientData)ArgumentsTk_Window tkwin (in) Token for window in which events may occur. unsigned long mask (in) Bit-mask of events (such as ButtonPressMask) for which proc should be called. Tk_EventProc *proc (in) Procedure to invoke whenever an event…

Tk_CreateErrorHandler, Tk_DeleteErrorHandler – handle X protocol errors Synopsis#include <tk.h> Tk_ErrorHandler Tk_CreateErrorHandler(display, error, request, minor, proc, clientData) Tk_DeleteErrorHandler(handler)ArgumentsDisplay *display (in) Display whose errors are to be handled. int error (in) Match only error events with this value in the error_code field. If -1, then match any error_code value. int request (in) Match only error events with…

Tk_CreateClientMessageHandler, Tk_DeleteClientMessageHandler – associate procedure callback with ClientMessage type X events Synopsis#include <tk.h> Tk_CreateClientMessageHandler(proc) Tk_DeleteClientMessageHandler(proc)ArgumentsTk_ClientMessageProc *proc (in) Procedure to invoke whenever a ClientMessage X event occurs on any display. DescriptionTk_CreateClientMessageHandler arranges for proc to be invoked in the future whenever a ClientMessage X event occurs that is not handled by WM_PROTOCOL. Tk_CreateClientMessageHandler is intended for…

Tk_CreateBindingTable, Tk_DeleteBindingTable, Tk_CreateBinding, Tk_DeleteBinding, Tk_GetBinding, Tk_GetAllBindings, Tk_DeleteAllBindings, Tk_BindEvent – invoke scripts in response to X events Synopsis#include <tk.h> Tk_BindingTable Tk_CreateBindingTable(interp) Tk_DeleteBindingTable(bindingTable) unsigned long Tk_CreateBinding(interp, bindingTable, object, eventString, script, append) int Tk_DeleteBinding(interp, bindingTable, object, eventString) const char * Tk_GetBinding(interp, bindingTable, object, eventString) Tk_GetAllBindings(interp, bindingTable, object) Tk_DeleteAllBindings(bindingTable, object) Tk_BindEvent(bindingTable, eventPtr, tkwin, numObjects, objectPtr)ArgumentsTcl_Interp *interp (in) Interpreter to…

Tk_CreateBindingTable, Tk_DeleteBindingTable, Tk_CreateBinding, Tk_DeleteBinding, Tk_GetBinding, Tk_GetAllBindings, Tk_DeleteAllBindings, Tk_BindEvent – invoke scripts in response to X events Synopsis#include <tk.h> Tk_BindingTable Tk_CreateBindingTable(interp) Tk_DeleteBindingTable(bindingTable) unsigned long Tk_CreateBinding(interp, bindingTable, object, eventString, script, append) int Tk_DeleteBinding(interp, bindingTable, object, eventString) const char * Tk_GetBinding(interp, bindingTable, object, eventString) Tk_GetAllBindings(interp, bindingTable, object) Tk_DeleteAllBindings(bindingTable, object) Tk_BindEvent(bindingTable, eventPtr, tkwin, numObjects, objectPtr)ArgumentsTcl_Interp *interp (in) Interpreter to…

Tk_CoordsToWindow – Find window containing a point Synopsis#include <tk.h> Tk_Window Tk_CoordsToWindow(rootX, rootY, tkwin)Argumentsint rootX (in) X-coordinate (in root window coordinates). int rootY (in) Y-coordinate (in root window coordinates). Tk_Window tkwin (in) Token for window that identifies application. DescriptionTk_CoordsToWindow locates the window that contains a given point. The point is specified in root coordinates with rootX…

Tk_ConfigureWindow, Tk_MoveWindow, Tk_ResizeWindow, Tk_MoveResizeWindow, Tk_SetWindowBorderWidth, Tk_ChangeWindowAttributes, Tk_SetWindowBackground, Tk_SetWindowBackgroundPixmap, Tk_SetWindowBorder, Tk_SetWindowBorderPixmap, Tk_SetWindowColormap, Tk_DefineCursor, Tk_UndefineCursor – change window configuration or attributes Synopsis#include <tk.h> Tk_ConfigureWindow(tkwin, valueMask, valuePtr) Tk_MoveWindow(tkwin, x, y) Tk_ResizeWindow(tkwin, width, height) Tk_MoveResizeWindow(tkwin, x, y, width, height) Tk_SetWindowBorderWidth(tkwin, borderWidth) Tk_ChangeWindowAttributes(tkwin, valueMask, attsPtr) Tk_SetWindowBackground(tkwin, pixel) Tk_SetWindowBackgroundPixmap(tkwin, pixmap) Tk_SetWindowBorder(tkwin, pixel) Tk_SetWindowBorderPixmap(tkwin, pixmap) Tk_SetWindowColormap(tkwin, colormap) Tk_DefineCursor(tkwin, cursor) Tk_UndefineCursor(tkwin)ArgumentsTk_Window tkwin (in)…

Tk_ConfigureWidget, Tk_ConfigureInfo, Tk_ConfigureValue, Tk_FreeOptions – process configuration options for widgets Synopsis#include <tk.h> int Tk_ConfigureWidget(interp, tkwin, specs, argc, argv, widgRec, flags) int Tk_ConfigureInfo(interp, tkwin, specs, widgRec, argvName, flags) int Tk_ConfigureValue(interp, tkwin, specs, widgRec, argvName, flags) Tk_FreeOptions(specs, widgRec, display, flags)ArgumentsTcl_Interp *interp (in) Interpreter to use for returning error messages. Tk_Window tkwin (in) Window used to represent widget…

Tk_ConfigureWidget, Tk_ConfigureInfo, Tk_ConfigureValue, Tk_FreeOptions – process configuration options for widgets Synopsis#include <tk.h> int Tk_ConfigureWidget(interp, tkwin, specs, argc, argv, widgRec, flags) int Tk_ConfigureInfo(interp, tkwin, specs, widgRec, argvName, flags) int Tk_ConfigureValue(interp, tkwin, specs, widgRec, argvName, flags) Tk_FreeOptions(specs, widgRec, display, flags)ArgumentsTcl_Interp *interp (in) Interpreter to use for returning error messages. Tk_Window tkwin (in) Window used to represent widget…

Tk_ConfigureWidget, Tk_ConfigureInfo, Tk_ConfigureValue, Tk_FreeOptions – process configuration options for widgets Synopsis#include <tk.h> int Tk_ConfigureWidget(interp, tkwin, specs, argc, argv, widgRec, flags) int Tk_ConfigureInfo(interp, tkwin, specs, widgRec, argvName, flags) int Tk_ConfigureValue(interp, tkwin, specs, widgRec, argvName, flags) Tk_FreeOptions(specs, widgRec, display, flags)ArgumentsTcl_Interp *interp (in) Interpreter to use for returning error messages. Tk_Window tkwin (in) Window used to represent widget…

Tk_ComputeTextLayout, Tk_FreeTextLayout, Tk_DrawTextLayout, Tk_UnderlineTextLayout, Tk_PointToChar, Tk_CharBbox, Tk_DistanceToTextLayout, Tk_IntersectTextLayout, Tk_TextLayoutToPostscript – routines to measure and display single-font, multi-line, justified text. Synopsis#include <tk.h> Tk_TextLayout Tk_ComputeTextLayout(tkfont, string, numChars, wrapLength, justify, flags, widthPtr, heightPtr) void Tk_FreeTextLayout(layout) void Tk_DrawTextLayout(display, drawable, gc, layout, x, y, firstChar, lastChar) void Tk_UnderlineTextLayout(display, drawable, gc, layout, x, y, underline) int Tk_PointToChar(layout, x, y) int Tk_CharBbox(layout,…

Tk_WindowId, Tk_Parent, Tk_Display, Tk_DisplayName, Tk_ScreenNumber, Tk_Screen, Tk_X, Tk_Y, Tk_Width, Tk_Height, Tk_Changes, Tk_Attributes, Tk_IsContainer, Tk_IsEmbedded, Tk_IsMapped, Tk_IsTopLevel, Tk_ReqWidth, Tk_ReqHeight, Tk_MinReqWidth, Tk_MinReqHeight, Tk_InternalBorderLeft, Tk_InternalBorderRight, Tk_InternalBorderTop, Tk_InternalBorderBottom, Tk_Visual, Tk_Depth, Tk_Colormap, Tk_Interp – retrieve information from Tk’s local data structure Synopsis#include <tk.h> Window Tk_WindowId(tkwin) Tk_Window Tk_Parent(tkwin) Display * Tk_Display(tkwin) const char * Tk_DisplayName(tkwin) int Tk_ScreenNumber(tkwin) Screen * Tk_Screen(tkwin) int…

Tk_CollapseMotionEvents, Tk_QueueWindowEvent – Add a window event to the Tcl event queue Synopsis#include <tk.h> int Tk_CollapseMotionEvents(display, collapse) Tk_QueueWindowEvent(eventPtr, position)ArgumentsDisplay *display (in) Display for which to control motion event collapsing. int collapse (in) Indicates whether motion events should be collapsed or not. XEvent *eventPtr (in) An event to add to the event queue. It is important…