Chip 2000 May

home *** CD-ROM | disk | FTP | other *** search

/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _27482f9f19ebb47ef664dca60d1dbaf0 < prev next >

Wrap

Text File | 2000-03-23 | 25.3 KB | 501 lines

<HTML> <HEAD> <TITLE>Tk::TixGrid - Create and manipulate Tix Grid widgets</TITLE> <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css"> <LINK REV="made" HREF="mailto:"> </HEAD> <BODY> <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%> <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc"> Tk::TixGrid - Create and manipulate Tix Grid widgets </TD></TR> </TABLE> <A NAME="__index__"></A>  <UL> <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI> <LI><A HREF="#synopsis">SYNOPSIS</A></LI> <LI><A HREF="#standard options">STANDARD OPTIONS</A></LI> <LI><A HREF="#widgetspecific options">WIDGET-SPECIFIC OPTIONS</A></LI> <LI><A HREF="#description">DESCRIPTION</A></LI> <LI><A HREF="#widget methods">WIDGET METHODS</A></LI> <LI><A HREF="#bindings">BINDINGS</A></LI> <LI><A HREF="#see also">SEE ALSO</A></LI> <LI><A HREF="#bugs">BUGS</A></LI> <LI><A HREF="#keywords">KEYWORDS</A></LI> </UL>  <HR> <H1><A NAME="name">NAME</A></H1> Tk::TixGrid - Create and manipulate Tix Grid widgets <HR> <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1> <UL> <LI>Linux</LI> <LI>Solaris</LI> <LI>Windows</LI> </UL> <HR> <H1><A NAME="synopsis">SYNOPSIS</A></H1> $tixgrid = $parent->TixGrid?(options)?; <PRE> The port of C code and bindings is done but needs debugging. THERE ARE KNOWN BUGS. Work in progress ...</PRE> <HR> <H1><A NAME="standard options">STANDARD OPTIONS</A></H1> <TABLE CELLSPACING=0 CELLPADDING=0><TR><TD>-background <TR><TD><TD>-borderwidth <TR><TD><TD>-cursor <TR><TD><TD>-font <TR><TD><TD>-foreground <TR><TD><TD>-height <TR><TD><TD>-highlightbackground <TR><TD><TD>-highlightcolor <TR><TD><TD>-highlightthickness <TR><TD><TD>-padx <TR><TD><TD>-pady <TR><TD><TD>-relief <TR><TD><TD>-selectbackground <TR><TD><TD>-selectborderwidth <TR><TD><TD>-selectforeground <TR><TD><TD>-state <TR><TD><TD>-takefocus <TR><TD><TD>-width <TR><TD><TD>-xscrollcommand <TR><TD><TD>-yscrollcommand</TABLE> See <A HREF="../../../site/lib/Tk/options.html">the Tk::options manpage</A> for details of the standard options. <HR> <H1><A NAME="widgetspecific options">WIDGET-SPECIFIC OPTIONS</A></H1> <DL> <DT><A NAME="item_Name%3A_browseCmd">Name: browseCmd</A> <DD> <DT><A NAME="item_Class%3A_BrowseCmd">Class: BrowseCmd</A> <DD> <DT><A NAME="item_Switch%3A_%2Dbrowsecmd">Switch: -browsecmd</A> <DD> ?docu here? Not in configure output but used in bindings ??!! If defined, gives a perl/Tk <A HREF="../../../site/lib/Tk/callbacks.html">callback</A> to be executed when the user browses a grid cell (This is normally the case when the user clicks on an entry). When this callback is called, it is passed with two additional parameters: x y, where (x,y) is the location of the cell that has just been clicked. <DT><A NAME="item_Name%3A_Command">Name: Command</A> <DD> <DT><A NAME="item_Class%3A_Command">Class: Command</A> <DD> <DT><A NAME="item_Switch%3A_%2Dcommand">Switch: -command</A> <DD> ?docu here? Not in configure output but used in bindings ??!! <DT><A NAME="item_Name%3A_editDoneCmd">Name: editDoneCmd</A> <DD> <DT><A NAME="item_Class%3A_EditDoneCmd">Class: EditDoneCmd</A> <DD> <DT><A NAME="item_Switch%3A_%2Deditdonecmd">Switch: -editdonecmd</A> <DD> If defined, gives a perl/Tk <A HREF="../../../site/lib/Tk/callbacks.html">callback</A> to be executed when the user has edited grid cell. When this callback is called, it is passed with two additional parameters: x y, where (x,y) is the location of the cell that has just been edited. <DT><A NAME="item_Name%3A_editNotifyCmd">Name: editNotifyCmd</A> <DD> <DT><A NAME="item_Class%3A_EditNotifyCmd">Class: EditNotifyCmd</A> <DD> <DT><A NAME="item_Switch%3A_%2Deditnotifycmd">Switch: -editnotifycmd</A> <DD> If defined gives a perl/Tk <A HREF="../../../site/lib/Tk/callbacks.html">callback</A> to be executed when the user tries to edit a grid cell. When this callback is called, it is passed with two additional parameters: x y, where (x,y,) is the location of the cell. This callback should return a boolean value: true indicates that the cell is editable and false otherwise. <DT><A NAME="item_Name%3A_FloatingCols">Name: FloatingCols</A> <DD> <DT><A NAME="item_Class%3A_floatingCols">Class: floatingCols</A> <DD> <DT><A NAME="item_Switch%3A_%2Dfloatingcols">Switch: -floatingcols</A> <DD> Defines the number of columns that fixed when the widget is horizontally scrolled. These <CODE>column(s)</CODE> can be used as <CODE>label(s)</CODE> for the column(s). The floating <CODE>column(s)</CODE> can be configured in the -formatcmd callback with the formatBorder method. The default value is 0. <DT><A NAME="item_Name%3A_FloatingRows">Name: FloatingRows</A> <DD> <DT><A NAME="item_Class%3A_floatingRows">Class: floatingRows</A> <DD> <DT><A NAME="item_Switch%3A_%2Dfloatingrows">Switch: -floatingrows</A> <DD> Defines the number of rows that are fixed when the widget is vertically scrolled. These <CODE>row(s)</CODE> can be used as <CODE>label(s)</CODE> for the row(s). The floating <CODE>row(s)</CODE> can be configured in the -formatcmd callback with the formatBorder method. The default value is 0. <DT><A NAME="item_Name%3A_formatCmd">Name: formatCmd</A> <DD> <DT><A NAME="item_Class%3A_FormatCmd">Class: FormatCmd</A> <DD> <DT><A NAME="item_Switch%3A_%2Dformatcmd">Switch: -formatcmd</A> <DD> If defined, gives a perl/Tk <A HREF="../../../site/lib/Tk/callbacks.html">callback</A> to be executed when the grid cells need to be formatted on the screen. Normally, this callback calls the format method (see below). When this callback is called, it is passed with five additional parameters: type x1 y1 x2 y2. type gives the logical type of the region in the grid. It may be one of the following. <DL> <DT><A NAME="item_x%2Dregion">x-region</A> <DD> the horizontal margin <DT><A NAME="item_y%2Dregion">y-region</A> <DD> the vertical margin <DT><A NAME="item_s%2Dregion">s-region</A> <DD> the area where the horizontal and vertical margins are joined <DT><A NAME="item_main">main</A> <DD> all the cells that do not fall into the above three types </DL> x1 y1 x2 y2 gives the extent of the region that needs formatting. <DT><A NAME="item_Name%3A_leftMargin">Name: leftMargin</A> <DD> <DT><A NAME="item_Class%3A_LeftMargin">Class: LeftMargin</A> <DD> <DT><A NAME="item_Switch%3A_%2Dleftmargin">Switch: -leftmargin</A> <DD> In the number of cells, gives the width of vertical margin. A zero indicates that no vertical should be drawn. <DT><A NAME="item_Name%3A_itemType">Name: itemType</A> <DD> <DT><A NAME="item_Class%3A_ItemType">Class: ItemType</A> <DD> <DT><A NAME="item_Switch%3A_%2Ditemtype">Switch: -itemtype</A> <DD> ?docu here? <DT><A NAME="item_Name%3A_selectMode">Name: selectMode</A> <DD> <DT><A NAME="item_Class%3A_SelectMode">Class: SelectMode</A> <DD> <DT><A NAME="item_Switch%3A_%2Dselectmode">Switch: -selectmode</A> <DD> Specifies one of several styles for manipulating the selection. The value of the option may be arbitrary, but the default bindings expect it to be either single, browse, multiple, or extended; the default value is single. <DT><A NAME="item_Name%3A_selectUnit">Name: selectUnit</A> <DD> <DT><A NAME="item_Class%3A_SelectUnit">Class: SelectUnit</A> <DD> <DT><A NAME="item_Switch%3A_%2Dselectunit">Switch: -selectunit</A> <DD> Specifies the selection unit. Valid values are cell, column or row. <DT><A NAME="item_Name%3A_sizeCmd">Name: sizeCmd</A> <DD> <DT><A NAME="item_Class%3A_SizeCmd">Class: SizeCmd</A> <DD> <DT><A NAME="item_Switch%3A_%2Dsizecmd">Switch: -sizecmd</A> <DD> ?docu here? <DT><A NAME="item_Name%3A_topMargin">Name: topMargin</A> <DD> <DT><A NAME="item_Class%3A_TopMargin">Class: TopMargin</A> <DD> <DT><A NAME="item_Switch%3A_%2Dtopmargin">Switch: -topmargin</A> <DD> In the number of cells, gives the height of horizontal margin. A zero indicates that no horizontal should be drawn. </DL> <HR> <H1><A NAME="description">DESCRIPTION</A></H1> The TixGrid method creates a TixGrid new window and returns a blessed reference of this TixGrid widget. Additional options, described above, may be specified on the command line or in the option database to configure aspects of the TixGrid widget such as its cursor and relief. A Grid widget displays its contents in a two dimensional grid of cells. Each cell may contain one Tix display item, which may be in text, graphics or other formats. See <A HREF="../../../site/lib/Tk/DItem.html">the Tk::DItem manpage</A> for more information about Tix display items. Individual cells, or groups of cells, can be formatted with a wide range of attributes, such as its color, relief and border. <HR> <H1><A NAME="widget methods">WIDGET METHODS</A></H1> The TixGrid method creates a TixGrid widget and returns a blessed reference of this TixGrid widget. This reference may be used to invoke various operations on the widget. It has the following general form: $tixgrid->method?(arg, arg, ...)? args determine the exact behavior of the method. The following methods are possible for TixGrid widgets: <DL> <DT><A NAME="item_anchor">$tixgrid->anchor(action, x, y)</A> <DD> <DT><A NAME="item_anchorAction">$tixgrid->anchorAction(x, y)</A> <DD> Manipulates the anchor cell of the TixGrid widget. The anchor cell is the end of the selection that is fixed while the user is dragging out a selection with the mouse. Action can be clear, get or set. If action is clear, x and y args are not accepted. <DT><A NAME="item_bdtype">$tixgrid->bdtype(x, y ?,xbdWidth, ybdWidth?)</A> <DD> ???? <DT><A NAME="item_cget">$tixgrid->cget('-option')</A> <DD> Returns the current value of the configuration option given by -option. -option may have any of the values accepted by the TixGrid constructor method. <DT><A NAME="item_configure">$tixgrid->configure(?-option??=>value, -option=>value, ...?)</A> <DD> Query or modify the configuration options of the widget. If no -option is specified, returns a list describing all of the available options for $tixgrid (see Tk_ConfigureInfo for information on the format of this list.) If -option is specified with no value, then the method returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no -option is specified). If one or more option-value pairs are specified, then the method modifies the given widget <CODE>option(s)</CODE> to have the given value(s); in this case the method returns an empty string. -option may have any of the values accepted by the TixGrid constructor method. <DT><A NAME="item_delete">$tixgrid->delete(dim, from?, to?)</A> <DD> <DT><A NAME="item_deleteColumn">$tixgrid->deleteColumn(from?, to?)</A> <DD> <DT><A NAME="item_deleteRow">$tixgrid->deleteRow(from?, to?)</A> <DD> Dim may be row or column. If to is not given, deletes a single row (or column) at the position from. If to is given, deletes the range of rows (or columns) from position from through to. <DT><A NAME="item_dragsite">$tixgrid->dragsite(option, x, y)</A> <DD> ?docu here? not implemented :-( <DT><A NAME="item_dropsite">$tixgrid->dropsite(option, x, y)</A> <DD> ?docu here? not implemented :-( <DT><A NAME="item_editApply">$tixgrid->editApply</A> <DD> If any cell is being edited, de-highlight the cell and applies the changes. <DT><A NAME="item_editSet">$tixgrid->editSet(x, y)</A> <DD> Highlights the cell at (x,y) for editing, if the -editnotify callback returns true for this cell. <DT><A NAME="item_entrycget">$tixgrid->entrycget(x, y, '-option')</A> <DD> Returns the current value of the configuration option given by -option of the cell at (x,y). -option may have any of the values accepted by the set method. <DT><A NAME="item_entryconfigure">$tixgrid->entryconfigure(x, y?, -option??=>value, -option=>value, ...?)</A> <DD> Query or modify the configuration options of the cell at (x,y). If no -option is specified, returns a list describing all of the available options for the cell (see Tk_ConfigureInfo for information on the format of this list.) If -option is specified with no value, then the method returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no -option is specified.) If one or more option-value pairs are specified, then the method modifies the given widget <CODE>option(s)</CODE> to have the given value(s); in this case the method returns an empty string. Option may have any of the values accepted by the set method. <DT><A NAME="item_format">$tixgrid->format(option, ?args, ...?)</A> <DD> <DT><A NAME="item_formatBorder">$tixgrid->formatBorder(x1,y1, x2,y2, options);</A> <DD> <DT><A NAME="item_formatGrid">$tixgrid->formatGrid(x1,y1, x2,y2, options);</A> <DD> the format method can only be called by the -formatcmd callback of the tixGrid widget. ?docu complete? <DT><A NAME="item_geometryinfo">$tixgrid->geometryinfo(?width, ?height, ...?)</A> <DD> ?docu here? Return a list of 4 floats! Currently ``{first1 last1} {first2,last2}'' :-( <DT><A NAME="item_index">$tixgrid->index($coordx, $coordy)</A> <DD> ?docu here? retuns (nx, ny) of entry at position ($coordx, $coordy). (??widget or screen offset??) <DT><A NAME="item_info">$tixgrid->info(option, ?args, ...?)</A> <DD> ?docu here? <DT><A NAME="item_move">$tixgrid->move(dim, from, to, offset)</A> <DD> <DT><A NAME="item_moveColumn">$tixgrid->moveColumn(from, to, offset)</A> <DD> <DT><A NAME="item_moveRow">$tixgrid->moveRow(from, to, offset)</A> <DD> Dim may be row or column. Moves the range of rows (or columns) from position from through to by the distance indicated by offset. For example, $tixgrid->moveRow(2, 4, 1) moves the rows 2,3,4 to rows 3,4,5. <DT><A NAME="item_nearest">$tixgrid->nearest(x, y)</A> <DD> ?docu here? screen pos (pixels) to entry (nx,ny) translation. <DT><A NAME="item_selection">$tixgrid->selection(option, x1, y1 ?,x2, y2?)</A> <DD> <DT><A NAME="item_selectionOption">$tixgrid->selectionOption(x1, y1 ?,x2, y2?)</A> <DD> Option one of: adjust, clear, includes, set, and toggle. x1 (y1) has not to be greater than x2 (y2), but only x2 and y2 can be 'max'. BUG: selection includes: has no visible effect (as in Tix). Eh??? BUG: selection clear: only works for 0, 0, max, max (as in Tix). Eh??? When x2, y2 are not given they default to x1, y1, respectively. <DL> <DT><A NAME="item_selectionAdjust">$tixgrid->selectionAdjust(x1, y1 ?,x2, y2?)</A> <DD> ?docu here? <DT><A NAME="item_selectionClear">$tixgrid->selectionClear(x1, y1 ?,x2, y2?)</A> <DD> ?docu here? <DT><A NAME="item_selectionIncludes">$tixgrid->selectionIncludes(x1, y1 ?,x2, y2?)</A> <DD> ?docu here? <DT><A NAME="item_selectionSet">$tixgrid->selectionSet(x1, y1 ?,x2, y2?)</A> <DD> ?docu here? <DT><A NAME="item_selectionToggle">$tixgrid->selectionToggle(x1, y1 ?,x2, y2?)</A> <DD> ?docu here? </DL> <DT><A NAME="item_set">$tixgrid->set(x, y?, -itemtype=>type??, -option=>value, ...?)</A> <DD> Creates a new display item at the cell at (x,y). The optional -itemtype parameter gives the type of the display item. An additional list of option-value pairs specify options of the display item. If a display item already exists at this cell, the old item will be deleted automatically. <DT><A NAME="item_size">$tixgrid->size(dim, index?, -option??=>value, ...?)</A> <DD> <DT><A NAME="item_sizeColumn">$tixgrid->sizeColumn(index?, -option??=>value, ...?)</A> <DD> <DT><A NAME="item_sizeRow">$tixgrid->sizeRow(index?, -option??=>value, ...?)</A> <DD> Queries or sets the size of the row or column given by dim and index. Dim may be row or column. Index may be any non-negative integer that gives the position of a given row (or column). Index can also be the string default; in this case, this method queries or sets the default size of all rows (or columns). When no option-value pair is given, this method returns a list containing the current size setting of the given row (or column). When option-value pairs are given, the corresponding options of the size setting of the given row are changed. -option may be one of the following: <DL> <DT><A NAME="item_%2Dpad0_%3D%3E_pixels">-pad0 => pixels</A> <DD> Specifies the paddings to the left of a column or the top of a row. <DT><A NAME="item_%2Dpad1_%3D%3E_pixels">-pad1 => pixels</A> <DD> Specifies the paddings to the right of a column or the bottom of a row. <DT><A NAME="item_%2Dsize_%3D%3E_val">-size => val</A> <DD> Specifies the width of a column or the height of a row. Val may be: auto -- the width of the column is set the widest cell in the column; a valid Tk screen distance unit (see Tk_GetPixels); or a real number following by the word chars (e.g. 3.4chars) that sets the width of the column to the given number of characters. </DL> <DT><A NAME="item_sort">$tixgrid->sort(dimension, start, end, ?args ...?)</A> <DD> ?docu here? (not supported on Win* OSs up to now) <DT><A NAME="item_unset">$tixgrid->unset(x, y)</A> <DD> Clears the cell at (x,y) by removing its display item. <DT><A NAME="item_xview">$tixgrid->xview</A> <DD> ?docu here? <DT><A NAME="item_yview">$tixgrid->yview</A> <DD> ?docu here? </DL> <HR> <H1><A NAME="bindings">BINDINGS</A></H1> to be done. <HR> <H1><A NAME="see also">SEE ALSO</A></H1> <A HREF="../../../site/lib/Tk/DItem.html">Tk::DItem</A> <A HREF="../../../site/lib/Tk/callbacks.html">Tk::callbacks</A> <A HREF="../../../site/lib/Tk/FloatEntry.html">Tk::FloatEntry</A> <HR> <H1><A NAME="bugs">BUGS</A></H1> C code and bindings of TixGrid have some bugs. <HR> <H1><A NAME="keywords">KEYWORDS</A></H1> tix, tixgrid, table, display item, spreadsheet <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%> <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc"> Tk::TixGrid - Create and manipulate Tix Grid widgets </TD></TR> </TABLE> </BODY> </HTML>