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) Arguments Tcl_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…

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) Arguments Tcl_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…

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) Arguments Tk_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…

Tk_CreatePhotoImageFormat – define new file format for photo images Synopsis #include <tk.h> Tk_CreatePhotoImageFormat(formatPtr) Arguments Tk_PhotoImageFormat *formatPtr (in) Structure that defines the new file format. Description Tk_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…

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_CreateItemType, Tk_GetItemTypes – define new kind of canvas item Synopsis #include <tk.h> Tk_CreateItemType(typePtr) Tk_ItemType * Tk_GetItemTypes() Arguments Tk_ItemType *typePtr (in) Structure that defines the new type of canvas item. Introduction Tk_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…

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) Arguments Tk_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….

Tk_CreateGenericHandler, Tk_DeleteGenericHandler – associate procedure callback with all X events Synopsis #include <tk.h> Tk_CreateGenericHandler(proc, clientData) Tk_DeleteGenericHandler(proc, clientData) Arguments Tk_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. Description Tk_CreateGenericHandler arranges for proc to be invoked in the future whenever any…

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) Arguments Tk_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…

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) Arguments Display *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…

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

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) Arguments Tcl_Interp *interp…

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) Arguments Tcl_Interp *interp…

Tk_CoordsToWindow – Find window containing a point Synopsis #include <tk.h> Tk_Window Tk_CoordsToWindow(rootX, rootY, tkwin) Arguments int 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. Description Tk_CoordsToWindow locates the window that contains a given point. The point is specified in…

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) Arguments…

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) Arguments Tcl_Interp *interp (in) Interpreter to use for returning error messages. Tk_Window tkwin (in) Window used…

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) Arguments Tcl_Interp *interp (in) Interpreter to use for returning error messages. Tk_Window tkwin (in) Window used…

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) Arguments Tcl_Interp *interp (in) Interpreter to use for returning error messages. Tk_Window tkwin (in) Window used…

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_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)…