tkTextTag.c
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:43k
源码类别:

通讯编程

开发平台:

Visual C++

  1. /* 
  2.  * tkTextTag.c --
  3.  *
  4.  * This module implements the "tag" subcommand of the widget command
  5.  * for text widgets, plus most of the other high-level functions
  6.  * related to tags.
  7.  *
  8.  * Copyright (c) 1992-1994 The Regents of the University of California.
  9.  * Copyright (c) 1994-1997 Sun Microsystems, Inc.
  10.  *
  11.  * See the file "license.terms" for information on usage and redistribution
  12.  * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  13.  *
  14.  * RCS: @(#) $Id: tkTextTag.c,v 1.8.2.1 2006/10/17 05:38:48 dgp Exp $
  15.  */
  16. #include "default.h"
  17. #include "tkPort.h"
  18. #include "tkInt.h"
  19. #include "tkText.h"
  20. static Tk_ConfigSpec tagConfigSpecs[] = {
  21.     {TK_CONFIG_BORDER, "-background", (char *) NULL, (char *) NULL,
  22. (char *) NULL, Tk_Offset(TkTextTag, border), TK_CONFIG_NULL_OK},
  23.     {TK_CONFIG_BITMAP, "-bgstipple", (char *) NULL, (char *) NULL,
  24. (char *) NULL, Tk_Offset(TkTextTag, bgStipple), TK_CONFIG_NULL_OK},
  25.     {TK_CONFIG_STRING, "-borderwidth", (char *) NULL, (char *) NULL,
  26. "0", Tk_Offset(TkTextTag, bdString),
  27. TK_CONFIG_DONT_SET_DEFAULT|TK_CONFIG_NULL_OK},
  28.     {TK_CONFIG_STRING, "-elide", (char *) NULL, (char *) NULL,
  29. "0", Tk_Offset(TkTextTag, elideString),
  30. TK_CONFIG_DONT_SET_DEFAULT|TK_CONFIG_NULL_OK},
  31.     {TK_CONFIG_BITMAP, "-fgstipple", (char *) NULL, (char *) NULL,
  32. (char *) NULL, Tk_Offset(TkTextTag, fgStipple), TK_CONFIG_NULL_OK},
  33.     {TK_CONFIG_FONT, "-font", (char *) NULL, (char *) NULL,
  34. (char *) NULL, Tk_Offset(TkTextTag, tkfont), TK_CONFIG_NULL_OK},
  35.     {TK_CONFIG_COLOR, "-foreground", (char *) NULL, (char *) NULL,
  36. (char *) NULL, Tk_Offset(TkTextTag, fgColor), TK_CONFIG_NULL_OK},
  37.     {TK_CONFIG_STRING, "-justify", (char *) NULL, (char *) NULL,
  38. (char *) NULL, Tk_Offset(TkTextTag, justifyString), TK_CONFIG_NULL_OK},
  39.     {TK_CONFIG_STRING, "-lmargin1", (char *) NULL, (char *) NULL,
  40. (char *) NULL, Tk_Offset(TkTextTag, lMargin1String), TK_CONFIG_NULL_OK},
  41.     {TK_CONFIG_STRING, "-lmargin2", (char *) NULL, (char *) NULL,
  42. (char *) NULL, Tk_Offset(TkTextTag, lMargin2String), TK_CONFIG_NULL_OK},
  43.     {TK_CONFIG_STRING, "-offset", (char *) NULL, (char *) NULL,
  44. (char *) NULL, Tk_Offset(TkTextTag, offsetString), TK_CONFIG_NULL_OK},
  45.     {TK_CONFIG_STRING, "-overstrike", (char *) NULL, (char *) NULL,
  46. (char *) NULL, Tk_Offset(TkTextTag, overstrikeString),
  47. TK_CONFIG_NULL_OK},
  48.     {TK_CONFIG_STRING, "-relief", (char *) NULL, (char *) NULL,
  49. (char *) NULL, Tk_Offset(TkTextTag, reliefString), TK_CONFIG_NULL_OK},
  50.     {TK_CONFIG_STRING, "-rmargin", (char *) NULL, (char *) NULL,
  51. (char *) NULL, Tk_Offset(TkTextTag, rMarginString), TK_CONFIG_NULL_OK},
  52.     {TK_CONFIG_STRING, "-spacing1", (char *) NULL, (char *) NULL,
  53. (char *) NULL, Tk_Offset(TkTextTag, spacing1String), TK_CONFIG_NULL_OK},
  54.     {TK_CONFIG_STRING, "-spacing2", (char *) NULL, (char *) NULL,
  55. (char *) NULL, Tk_Offset(TkTextTag, spacing2String), TK_CONFIG_NULL_OK},
  56.     {TK_CONFIG_STRING, "-spacing3", (char *) NULL, (char *) NULL,
  57. (char *) NULL, Tk_Offset(TkTextTag, spacing3String), TK_CONFIG_NULL_OK},
  58.     {TK_CONFIG_STRING, "-tabs", (char *) NULL, (char *) NULL,
  59. (char *) NULL, Tk_Offset(TkTextTag, tabString), TK_CONFIG_NULL_OK},
  60.     {TK_CONFIG_STRING, "-underline", (char *) NULL, (char *) NULL,
  61. (char *) NULL, Tk_Offset(TkTextTag, underlineString),
  62. TK_CONFIG_NULL_OK},
  63.     {TK_CONFIG_CUSTOM, "-wrap", (char *) NULL, (char *) NULL,
  64. (char *) NULL, Tk_Offset(TkTextTag, wrapMode),
  65. TK_CONFIG_NULL_OK, &TkTextWrapModeOption},
  66.     {TK_CONFIG_END, (char *) NULL, (char *) NULL, (char *) NULL,
  67. (char *) NULL, 0, 0}
  68. };
  69. /*
  70.  * Forward declarations for procedures defined later in this file:
  71.  */
  72. static void ChangeTagPriority _ANSI_ARGS_((TkText *textPtr,
  73.     TkTextTag *tagPtr, int prio));
  74. static TkTextTag * FindTag _ANSI_ARGS_((Tcl_Interp *interp,
  75.     TkText *textPtr, CONST char *tagName));
  76. static void SortTags _ANSI_ARGS_((int numTags,
  77.     TkTextTag **tagArrayPtr));
  78. static int TagSortProc _ANSI_ARGS_((CONST VOID *first,
  79.     CONST VOID *second));
  80. /*
  81.  *--------------------------------------------------------------
  82.  *
  83.  * TkTextTagCmd --
  84.  *
  85.  * This procedure is invoked to process the "tag" options of
  86.  * the widget command for text widgets. See the user documentation
  87.  * for details on what it does.
  88.  *
  89.  * Results:
  90.  * A standard Tcl result.
  91.  *
  92.  * Side effects:
  93.  * See the user documentation.
  94.  *
  95.  *--------------------------------------------------------------
  96.  */
  97. int
  98. TkTextTagCmd(textPtr, interp, argc, argv)
  99.     register TkText *textPtr; /* Information about text widget. */
  100.     Tcl_Interp *interp; /* Current interpreter. */
  101.     int argc; /* Number of arguments. */
  102.     CONST char **argv; /* Argument strings.  Someone else has already
  103.  * parsed this command enough to know that
  104.  * argv[1] is "tag". */
  105. {
  106.     int c, i, addTag;
  107.     size_t length;
  108.     char *fullOption;
  109.     register TkTextTag *tagPtr;
  110.     TkTextIndex first, last, index1, index2;
  111.     if (argc < 3) {
  112. Tcl_AppendResult(interp, "wrong # args: should be "",
  113. argv[0], " tag option ?arg arg ...?"", (char *) NULL);
  114. return TCL_ERROR;
  115.     }
  116.     c = argv[2][0];
  117.     length = strlen(argv[2]);
  118.     if ((c == 'a') && (strncmp(argv[2], "add", length) == 0)) {
  119. fullOption = "add";
  120. addTag = 1;
  121. addAndRemove:
  122. if (argc < 5) {
  123.     Tcl_AppendResult(interp, "wrong # args: should be "",
  124.     argv[0], " tag ", fullOption,
  125.     " tagName index1 ?index2 index1 index2 ...?"",
  126.     (char *) NULL);
  127.     return TCL_ERROR;
  128. }
  129. tagPtr = TkTextCreateTag(textPtr, argv[3]);
  130. for (i = 4; i < argc; i += 2) {
  131.     if (TkTextGetIndex(interp, textPtr, argv[i], &index1) != TCL_OK) {
  132. return TCL_ERROR;
  133.     }
  134.     if (argc > (i+1)) {
  135. if (TkTextGetIndex(interp, textPtr, argv[i+1], &index2)
  136. != TCL_OK) {
  137.     return TCL_ERROR;
  138. }
  139. if (TkTextIndexCmp(&index1, &index2) >= 0) {
  140.     return TCL_OK;
  141. }
  142.     } else {
  143. index2 = index1;
  144. TkTextIndexForwChars(&index2, 1, &index2);
  145.     }
  146.     if (tagPtr->affectsDisplay) {
  147. TkTextRedrawTag(textPtr, &index1, &index2, tagPtr, !addTag);
  148.     } else {
  149. /*
  150.  * Still need to trigger enter/leave events on tags that
  151.  * have changed.
  152.  */
  153. TkTextEventuallyRepick(textPtr);
  154.     }
  155.     TkBTreeTag(&index1, &index2, tagPtr, addTag);
  156.     /*
  157.      * If the tag is "sel" then grab the selection if we're supposed
  158.      * to export it and don't already have it.  Also, invalidate
  159.      * partially-completed selection retrievals.
  160.      */
  161.     if (tagPtr == textPtr->selTagPtr) {
  162. XEvent event;
  163. /*
  164.  * Send an event that the selection changed.
  165.  * This is equivalent to
  166.  * "event generate $textWidget <<Selection>>"
  167.  */
  168. memset((VOID *) &event, 0, sizeof(event));
  169. event.xany.type = VirtualEvent;
  170. event.xany.serial = NextRequest(Tk_Display(textPtr->tkwin));
  171. event.xany.send_event = False;
  172. event.xany.window = Tk_WindowId(textPtr->tkwin);
  173. event.xany.display = Tk_Display(textPtr->tkwin);
  174. ((XVirtualEvent *) &event)->name = Tk_GetUid("Selection");
  175. Tk_HandleEvent(&event);
  176. if (addTag && textPtr->exportSelection
  177. && !(textPtr->flags & GOT_SELECTION)) {
  178.     Tk_OwnSelection(textPtr->tkwin, XA_PRIMARY,
  179.     TkTextLostSelection, (ClientData) textPtr);
  180.     textPtr->flags |= GOT_SELECTION;
  181. }
  182. textPtr->abortSelections = 1;
  183.     }
  184. }
  185.     } else if ((c == 'b') && (strncmp(argv[2], "bind", length) == 0)) {
  186. if ((argc < 4) || (argc > 6)) {
  187.     Tcl_AppendResult(interp, "wrong # args: should be "",
  188.     argv[0], " tag bind tagName ?sequence? ?command?"",
  189.     (char *) NULL);
  190.     return TCL_ERROR;
  191. }
  192. tagPtr = TkTextCreateTag(textPtr, argv[3]);
  193. /*
  194.  * Make a binding table if the widget doesn't already have
  195.  * one.
  196.  */
  197. if (textPtr->bindingTable == NULL) {
  198.     textPtr->bindingTable = Tk_CreateBindingTable(interp);
  199. }
  200. if (argc == 6) {
  201.     int append = 0;
  202.     unsigned long mask;
  203.     if (argv[5][0] == 0) {
  204. return Tk_DeleteBinding(interp, textPtr->bindingTable,
  205. (ClientData) tagPtr, argv[4]);
  206.     }
  207.     if (argv[5][0] == '+') {
  208. argv[5]++;
  209. append = 1;
  210.     }
  211.     mask = Tk_CreateBinding(interp, textPtr->bindingTable,
  212.     (ClientData) tagPtr, argv[4], argv[5], append);
  213.     if (mask == 0) {
  214. return TCL_ERROR;
  215.     }
  216.     if (mask & (unsigned) ~(ButtonMotionMask|Button1MotionMask
  217.     |Button2MotionMask|Button3MotionMask|Button4MotionMask
  218.     |Button5MotionMask|ButtonPressMask|ButtonReleaseMask
  219.     |EnterWindowMask|LeaveWindowMask|KeyPressMask
  220.     |KeyReleaseMask|PointerMotionMask|VirtualEventMask)) {
  221. Tk_DeleteBinding(interp, textPtr->bindingTable,
  222. (ClientData) tagPtr, argv[4]);
  223. Tcl_ResetResult(interp);
  224. Tcl_AppendResult(interp, "requested illegal events; ",
  225. "only key, button, motion, enter, leave, and virtual ",
  226. "events may be used", (char *) NULL);
  227. return TCL_ERROR;
  228.     }
  229. } else if (argc == 5) {
  230.     CONST char *command;
  231.     
  232.     command = Tk_GetBinding(interp, textPtr->bindingTable,
  233.     (ClientData) tagPtr, argv[4]);
  234.     if (command == NULL) {
  235. CONST char *string = Tcl_GetStringResult(interp); 
  236. /*
  237.  * Ignore missing binding errors.  This is a special hack
  238.  * that relies on the error message returned by FindSequence
  239.  * in tkBind.c.
  240.  */
  241. if (string[0] != '') {
  242.     return TCL_ERROR;
  243. } else {
  244.     Tcl_ResetResult(interp);
  245. }
  246.     } else {
  247. Tcl_SetResult(interp, (char *) command, TCL_STATIC);
  248.     }
  249. } else {
  250.     Tk_GetAllBindings(interp, textPtr->bindingTable,
  251.     (ClientData) tagPtr);
  252. }
  253.     } else if ((c == 'c') && (strncmp(argv[2], "cget", length) == 0)
  254.     && (length >= 2)) {
  255. if (argc != 5) {
  256.     Tcl_AppendResult(interp, "wrong # args: should be "",
  257.     argv[0], " tag cget tagName option"",
  258.     (char *) NULL);
  259.     return TCL_ERROR;
  260. }
  261. tagPtr = FindTag(interp, textPtr, argv[3]);
  262. if (tagPtr == NULL) {
  263.     return TCL_ERROR;
  264. }
  265. return Tk_ConfigureValue(interp, textPtr->tkwin, tagConfigSpecs,
  266. (char *) tagPtr, argv[4], 0);
  267.     } else if ((c == 'c') && (strncmp(argv[2], "configure", length) == 0)
  268.     && (length >= 2)) {
  269. if (argc < 4) {
  270.     Tcl_AppendResult(interp, "wrong # args: should be "",
  271.     argv[0], " tag configure tagName ?option? ?value? ",
  272.     "?option value ...?"", (char *) NULL);
  273.     return TCL_ERROR;
  274. }
  275. tagPtr = TkTextCreateTag(textPtr, argv[3]);
  276. if (argc == 4) {
  277.     return Tk_ConfigureInfo(interp, textPtr->tkwin, tagConfigSpecs,
  278.     (char *) tagPtr, (char *) NULL, 0);
  279. } else if (argc == 5) {
  280.     return Tk_ConfigureInfo(interp, textPtr->tkwin, tagConfigSpecs,
  281.     (char *) tagPtr, argv[4], 0);
  282. } else {
  283.     int result;
  284.     result = Tk_ConfigureWidget(interp, textPtr->tkwin, tagConfigSpecs,
  285.     argc-4, argv+4, (char *) tagPtr, 0);
  286.     /*
  287.      * Some of the configuration options, like -underline
  288.      * and -justify, require additional translation (this is
  289.      * needed because we need to distinguish a particular value
  290.      * of an option from "unspecified").
  291.      */
  292.     if (tagPtr->bdString != NULL) {
  293. if (Tk_GetPixels(interp, textPtr->tkwin, tagPtr->bdString,
  294. &tagPtr->borderWidth) != TCL_OK) {
  295.     return TCL_ERROR;
  296. }
  297. if (tagPtr->borderWidth < 0) {
  298.     tagPtr->borderWidth = 0;
  299. }
  300.     }
  301.     if (tagPtr->reliefString != NULL) {
  302. if (Tk_GetRelief(interp, tagPtr->reliefString,
  303. &tagPtr->relief) != TCL_OK) {
  304.     return TCL_ERROR;
  305. }
  306.     }
  307.     if (tagPtr->justifyString != NULL) {
  308. if (Tk_GetJustify(interp, tagPtr->justifyString,
  309. &tagPtr->justify) != TCL_OK) {
  310.     return TCL_ERROR;
  311. }
  312.     }
  313.     if (tagPtr->lMargin1String != NULL) {
  314. if (Tk_GetPixels(interp, textPtr->tkwin,
  315. tagPtr->lMargin1String, &tagPtr->lMargin1) != TCL_OK) {
  316.     return TCL_ERROR;
  317. }
  318.     }
  319.     if (tagPtr->lMargin2String != NULL) {
  320. if (Tk_GetPixels(interp, textPtr->tkwin,
  321. tagPtr->lMargin2String, &tagPtr->lMargin2) != TCL_OK) {
  322.     return TCL_ERROR;
  323. }
  324.     }
  325.     if (tagPtr->offsetString != NULL) {
  326. if (Tk_GetPixels(interp, textPtr->tkwin, tagPtr->offsetString,
  327. &tagPtr->offset) != TCL_OK) {
  328.     return TCL_ERROR;
  329. }
  330.     }
  331.     if (tagPtr->overstrikeString != NULL) {
  332. if (Tcl_GetBoolean(interp, tagPtr->overstrikeString,
  333. &tagPtr->overstrike) != TCL_OK) {
  334.     return TCL_ERROR;
  335. }
  336.     }
  337.     if (tagPtr->rMarginString != NULL) {
  338. if (Tk_GetPixels(interp, textPtr->tkwin,
  339. tagPtr->rMarginString, &tagPtr->rMargin) != TCL_OK) {
  340.     return TCL_ERROR;
  341. }
  342.     }
  343.     if (tagPtr->spacing1String != NULL) {
  344. if (Tk_GetPixels(interp, textPtr->tkwin,
  345. tagPtr->spacing1String, &tagPtr->spacing1) != TCL_OK) {
  346.     return TCL_ERROR;
  347. }
  348. if (tagPtr->spacing1 < 0) {
  349.     tagPtr->spacing1 = 0;
  350. }
  351.     }
  352.     if (tagPtr->spacing2String != NULL) {
  353. if (Tk_GetPixels(interp, textPtr->tkwin,
  354. tagPtr->spacing2String, &tagPtr->spacing2) != TCL_OK) {
  355.     return TCL_ERROR;
  356. }
  357. if (tagPtr->spacing2 < 0) {
  358.     tagPtr->spacing2 = 0;
  359. }
  360.     }
  361.     if (tagPtr->spacing3String != NULL) {
  362. if (Tk_GetPixels(interp, textPtr->tkwin,
  363. tagPtr->spacing3String, &tagPtr->spacing3) != TCL_OK) {
  364.     return TCL_ERROR;
  365. }
  366. if (tagPtr->spacing3 < 0) {
  367.     tagPtr->spacing3 = 0;
  368. }
  369.     }
  370.     if (tagPtr->tabArrayPtr != NULL) {
  371. ckfree((char *) tagPtr->tabArrayPtr);
  372. tagPtr->tabArrayPtr = NULL;
  373.     }
  374.     if (tagPtr->tabString != NULL) {
  375. tagPtr->tabArrayPtr = TkTextGetTabs(interp, textPtr->tkwin,
  376. tagPtr->tabString);
  377. if (tagPtr->tabArrayPtr == NULL) {
  378.     return TCL_ERROR;
  379. }
  380.     }
  381.     if (tagPtr->underlineString != NULL) {
  382. if (Tcl_GetBoolean(interp, tagPtr->underlineString,
  383. &tagPtr->underline) != TCL_OK) {
  384.     return TCL_ERROR;
  385. }
  386.     }
  387.     if (tagPtr->elideString != NULL) {
  388. if (Tcl_GetBoolean(interp, tagPtr->elideString,
  389. &tagPtr->elide) != TCL_OK) {
  390.     return TCL_ERROR;
  391. }
  392.     }
  393.     /*
  394.      * If the "sel" tag was changed, be sure to mirror information
  395.      * from the tag back into the text widget record.   NOTE: we
  396.      * don't have to free up information in the widget record
  397.      * before overwriting it, because it was mirrored in the tag
  398.      * and hence freed when the tag field was overwritten.
  399.      */
  400.     if (tagPtr == textPtr->selTagPtr) {
  401. textPtr->selBorder = tagPtr->border;
  402. textPtr->selBdString = tagPtr->bdString;
  403. textPtr->selFgColorPtr = tagPtr->fgColor;
  404.     }
  405.     tagPtr->affectsDisplay = 0;
  406.     if ((tagPtr->border != NULL)
  407.     || (tagPtr->bdString != NULL)
  408.     || (tagPtr->reliefString != NULL)
  409.     || (tagPtr->bgStipple != None)
  410.     || (tagPtr->fgColor != NULL) || (tagPtr->tkfont != None)
  411.     || (tagPtr->fgStipple != None)
  412.     || (tagPtr->justifyString != NULL)
  413.     || (tagPtr->lMargin1String != NULL)
  414.     || (tagPtr->lMargin2String != NULL)
  415.     || (tagPtr->offsetString != NULL)
  416.     || (tagPtr->overstrikeString != NULL)
  417.     || (tagPtr->rMarginString != NULL)
  418.     || (tagPtr->spacing1String != NULL)
  419.     || (tagPtr->spacing2String != NULL)
  420.     || (tagPtr->spacing3String != NULL)
  421.     || (tagPtr->tabString != NULL)
  422.     || (tagPtr->underlineString != NULL)
  423.     || (tagPtr->elideString != NULL)
  424.     || (tagPtr->wrapMode != TEXT_WRAPMODE_NULL)) {
  425. tagPtr->affectsDisplay = 1;
  426.     }
  427.     TkTextRedrawTag(textPtr, (TkTextIndex *) NULL,
  428.     (TkTextIndex *) NULL, tagPtr, 1);
  429.     return result;
  430. }
  431.     } else if ((c == 'd') && (strncmp(argv[2], "delete", length) == 0)) {
  432. Tcl_HashEntry *hPtr;
  433. if (argc < 4) {
  434.     Tcl_AppendResult(interp, "wrong # args: should be "",
  435.     argv[0], " tag delete tagName tagName ..."",
  436.     (char *) NULL);
  437.     return TCL_ERROR;
  438. }
  439. for (i = 3; i < argc; i++) {
  440.     hPtr = Tcl_FindHashEntry(&textPtr->tagTable, argv[i]);
  441.     if (hPtr == NULL) {
  442. continue;
  443.     }
  444.     tagPtr = (TkTextTag *) Tcl_GetHashValue(hPtr);
  445.     if (tagPtr == textPtr->selTagPtr) {
  446. continue;
  447.     }
  448.     if (tagPtr->affectsDisplay) {
  449. TkTextRedrawTag(textPtr, (TkTextIndex *) NULL,
  450. (TkTextIndex *) NULL, tagPtr, 1);
  451.     }
  452.     TkTextMakeByteIndex(textPtr->tree, 0, 0, &first);
  453.     TkTextMakeByteIndex(textPtr->tree, TkBTreeNumLines(textPtr->tree),
  454.     0, &last),
  455.     TkBTreeTag(&first, &last, tagPtr, 0);
  456.     if (tagPtr == textPtr->selTagPtr) {
  457. XEvent event;
  458. /*
  459.  * Send an event that the selection changed.
  460.  * This is equivalent to
  461.  * "event generate $textWidget <<Selection>>"
  462.  */
  463. memset((VOID *) &event, 0, sizeof(event));
  464. event.xany.type = VirtualEvent;
  465. event.xany.serial = NextRequest(Tk_Display(textPtr->tkwin));
  466. event.xany.send_event = False;
  467. event.xany.window = Tk_WindowId(textPtr->tkwin);
  468. event.xany.display = Tk_Display(textPtr->tkwin);
  469. ((XVirtualEvent *) &event)->name = Tk_GetUid("Selection");
  470. Tk_HandleEvent(&event);
  471.     }
  472.     Tcl_DeleteHashEntry(hPtr);
  473.     if (textPtr->bindingTable != NULL) {
  474. Tk_DeleteAllBindings(textPtr->bindingTable,
  475. (ClientData) tagPtr);
  476.     }
  477.     /*
  478.      * Update the tag priorities to reflect the deletion of this tag.
  479.      */
  480.     ChangeTagPriority(textPtr, tagPtr, textPtr->numTags-1);
  481.     textPtr->numTags -= 1;
  482.     TkTextFreeTag(textPtr, tagPtr);
  483. }
  484.     } else if ((c == 'l') && (strncmp(argv[2], "lower", length) == 0)) {
  485. TkTextTag *tagPtr2;
  486. int prio;
  487. if ((argc != 4) && (argc != 5)) {
  488.     Tcl_AppendResult(interp, "wrong # args: should be "",
  489.     argv[0], " tag lower tagName ?belowThis?"",
  490.     (char *) NULL);
  491.     return TCL_ERROR;
  492. }
  493. tagPtr = FindTag(interp, textPtr, argv[3]);
  494. if (tagPtr == NULL) {
  495.     return TCL_ERROR;
  496. }
  497. if (argc == 5) {
  498.     tagPtr2 = FindTag(interp, textPtr, argv[4]);
  499.     if (tagPtr2 == NULL) {
  500. return TCL_ERROR;
  501.     }
  502.     if (tagPtr->priority < tagPtr2->priority) {
  503. prio = tagPtr2->priority - 1;
  504.     } else {
  505. prio = tagPtr2->priority;
  506.     }
  507. } else {
  508.     prio = 0;
  509. }
  510. ChangeTagPriority(textPtr, tagPtr, prio);
  511. TkTextRedrawTag(textPtr, (TkTextIndex *) NULL, (TkTextIndex *) NULL,
  512. tagPtr, 1);
  513.     } else if ((c == 'n') && (strncmp(argv[2], "names", length) == 0)
  514.     && (length >= 2)) {
  515. TkTextTag **arrayPtr;
  516. int arraySize;
  517. if ((argc != 3) && (argc != 4)) {
  518.     Tcl_AppendResult(interp, "wrong # args: should be "",
  519.     argv[0], " tag names ?index?"",
  520.     (char *) NULL);
  521.     return TCL_ERROR;
  522. }
  523. if (argc == 3) {
  524.     Tcl_HashSearch search;
  525.     Tcl_HashEntry *hPtr;
  526.     arrayPtr = (TkTextTag **) ckalloc((unsigned)
  527.     (textPtr->numTags * sizeof(TkTextTag *)));
  528.     for (i = 0, hPtr = Tcl_FirstHashEntry(&textPtr->tagTable, &search);
  529.     hPtr != NULL; i++, hPtr = Tcl_NextHashEntry(&search)) {
  530. arrayPtr[i] = (TkTextTag *) Tcl_GetHashValue(hPtr);
  531.     }
  532.     arraySize = textPtr->numTags;
  533. } else {
  534.     if (TkTextGetIndex(interp, textPtr, argv[3], &index1)
  535.     != TCL_OK) {
  536. return TCL_ERROR;
  537.     }
  538.     arrayPtr = TkBTreeGetTags(&index1, &arraySize);
  539.     if (arrayPtr == NULL) {
  540. return TCL_OK;
  541.     }
  542. }
  543. SortTags(arraySize, arrayPtr);
  544. for (i = 0; i < arraySize; i++) {
  545.     tagPtr = arrayPtr[i];
  546.     Tcl_AppendElement(interp, tagPtr->name);
  547. }
  548. ckfree((char *) arrayPtr);
  549.     } else if ((c == 'n') && (strncmp(argv[2], "nextrange", length) == 0)
  550.     && (length >= 2)) {
  551. TkTextSearch tSearch;
  552. char position[TK_POS_CHARS];
  553. if ((argc != 5) && (argc != 6)) {
  554.     Tcl_AppendResult(interp, "wrong # args: should be "",
  555.     argv[0], " tag nextrange tagName index1 ?index2?"",
  556.     (char *) NULL);
  557.     return TCL_ERROR;
  558. }
  559. tagPtr = FindTag((Tcl_Interp *) NULL, textPtr, argv[3]);
  560. if (tagPtr == NULL) {
  561.     return TCL_OK;
  562. }
  563. if (TkTextGetIndex(interp, textPtr, argv[4], &index1) != TCL_OK) {
  564.     return TCL_ERROR;
  565. }
  566. TkTextMakeByteIndex(textPtr->tree, TkBTreeNumLines(textPtr->tree),
  567. 0, &last);
  568. if (argc == 5) {
  569.     index2 = last;
  570. } else if (TkTextGetIndex(interp, textPtr, argv[5], &index2)
  571. != TCL_OK) {
  572.     return TCL_ERROR;
  573. }
  574. /*
  575.  * The search below is a bit tricky.  Rather than use the B-tree
  576.  * facilities to stop the search at index2, let it search up
  577.  * until the end of the file but check for a position past index2
  578.  * ourselves.  The reason for doing it this way is that we only
  579.  * care whether the *start* of the range is before index2;  once
  580.  * we find the start, we don't want TkBTreeNextTag to abort the
  581.  * search because the end of the range is after index2.
  582.  */
  583. TkBTreeStartSearch(&index1, &last, tagPtr, &tSearch);
  584. if (TkBTreeCharTagged(&index1, tagPtr)) {
  585.     TkTextSegment *segPtr;
  586.     int offset;
  587.     /*
  588.      * The first character is tagged.  See if there is an
  589.      * on-toggle just before the character.  If not, then
  590.      * skip to the end of this tagged range.
  591.      */
  592.     for (segPtr = index1.linePtr->segPtr, offset = index1.byteIndex; 
  593.     offset >= 0;
  594.     offset -= segPtr->size, segPtr = segPtr->nextPtr) {
  595. if ((offset == 0) && (segPtr->typePtr == &tkTextToggleOnType)
  596. && (segPtr->body.toggle.tagPtr == tagPtr)) {
  597.     goto gotStart;
  598. }
  599.     }
  600.     if (!TkBTreeNextTag(&tSearch)) {
  601.  return TCL_OK;
  602.     }
  603. }
  604. /*
  605.  * Find the start of the tagged range.
  606.  */
  607. if (!TkBTreeNextTag(&tSearch)) {
  608.     return TCL_OK;
  609. }
  610. gotStart:
  611. if (TkTextIndexCmp(&tSearch.curIndex, &index2) >= 0) {
  612.     return TCL_OK;
  613. }
  614. TkTextPrintIndex(&tSearch.curIndex, position);
  615. Tcl_AppendElement(interp, position);
  616. TkBTreeNextTag(&tSearch);
  617. TkTextPrintIndex(&tSearch.curIndex, position);
  618. Tcl_AppendElement(interp, position);
  619.     } else if ((c == 'p') && (strncmp(argv[2], "prevrange", length) == 0)
  620.     && (length >= 2)) {
  621. TkTextSearch tSearch;
  622. char position1[TK_POS_CHARS];
  623. char position2[TK_POS_CHARS];
  624. if ((argc != 5) && (argc != 6)) {
  625.     Tcl_AppendResult(interp, "wrong # args: should be "",
  626.     argv[0], " tag prevrange tagName index1 ?index2?"",
  627.     (char *) NULL);
  628.     return TCL_ERROR;
  629. }
  630. tagPtr = FindTag((Tcl_Interp *) NULL, textPtr, argv[3]);
  631. if (tagPtr == NULL) {
  632.     return TCL_OK;
  633. }
  634. if (TkTextGetIndex(interp, textPtr, argv[4], &index1) != TCL_OK) {
  635.     return TCL_ERROR;
  636. }
  637. if (argc == 5) {
  638.     TkTextMakeByteIndex(textPtr->tree, 0, 0, &index2);
  639. } else if (TkTextGetIndex(interp, textPtr, argv[5], &index2)
  640. != TCL_OK) {
  641.     return TCL_ERROR;
  642. }
  643. /*
  644.  * The search below is a bit weird.  The previous toggle can be
  645.  * either an on or off toggle. If it is an on toggle, then we
  646.  * need to turn around and search forward for the end toggle.
  647.  * Otherwise we keep searching backwards.
  648.  */
  649. TkBTreeStartSearchBack(&index1, &index2, tagPtr, &tSearch);
  650. if (!TkBTreePrevTag(&tSearch)) {
  651.     return TCL_OK;
  652. }
  653. if (tSearch.segPtr->typePtr == &tkTextToggleOnType) {
  654.     TkTextPrintIndex(&tSearch.curIndex, position1);
  655.     TkTextMakeByteIndex(textPtr->tree, TkBTreeNumLines(textPtr->tree),
  656.     0, &last);
  657.     TkBTreeStartSearch(&tSearch.curIndex, &last, tagPtr, &tSearch);
  658.     TkBTreeNextTag(&tSearch);
  659.     TkTextPrintIndex(&tSearch.curIndex, position2);
  660. } else {
  661.     TkTextPrintIndex(&tSearch.curIndex, position2);
  662.     TkBTreePrevTag(&tSearch);
  663.     if (TkTextIndexCmp(&tSearch.curIndex, &index2) < 0) {
  664. return TCL_OK;
  665.     }
  666.     TkTextPrintIndex(&tSearch.curIndex, position1);
  667. }
  668. Tcl_AppendElement(interp, position1);
  669. Tcl_AppendElement(interp, position2);
  670.     } else if ((c == 'r') && (strncmp(argv[2], "raise", length) == 0)
  671.     && (length >= 3)) {
  672. TkTextTag *tagPtr2;
  673. int prio;
  674. if ((argc != 4) && (argc != 5)) {
  675.     Tcl_AppendResult(interp, "wrong # args: should be "",
  676.     argv[0], " tag raise tagName ?aboveThis?"",
  677.     (char *) NULL);
  678.     return TCL_ERROR;
  679. }
  680. tagPtr = FindTag(interp, textPtr, argv[3]);
  681. if (tagPtr == NULL) {
  682.     return TCL_ERROR;
  683. }
  684. if (argc == 5) {
  685.     tagPtr2 = FindTag(interp, textPtr, argv[4]);
  686.     if (tagPtr2 == NULL) {
  687. return TCL_ERROR;
  688.     }
  689.     if (tagPtr->priority <= tagPtr2->priority) {
  690. prio = tagPtr2->priority;
  691.     } else {
  692. prio = tagPtr2->priority + 1;
  693.     }
  694. } else {
  695.     prio = textPtr->numTags-1;
  696. }
  697. ChangeTagPriority(textPtr, tagPtr, prio);
  698. TkTextRedrawTag(textPtr, (TkTextIndex *) NULL, (TkTextIndex *) NULL,
  699. tagPtr, 1);
  700.     } else if ((c == 'r') && (strncmp(argv[2], "ranges", length) == 0)
  701.     && (length >= 3)) {
  702. TkTextSearch tSearch;
  703. char position[TK_POS_CHARS];
  704. if (argc != 4) {
  705.     Tcl_AppendResult(interp, "wrong # args: should be "",
  706.     argv[0], " tag ranges tagName"", (char *) NULL);
  707.     return TCL_ERROR;
  708. }
  709. tagPtr = FindTag((Tcl_Interp *) NULL, textPtr, argv[3]);
  710. if (tagPtr == NULL) {
  711.     return TCL_OK;
  712. }
  713. TkTextMakeByteIndex(textPtr->tree, 0, 0, &first);
  714. TkTextMakeByteIndex(textPtr->tree, TkBTreeNumLines(textPtr->tree),
  715. 0, &last);
  716. TkBTreeStartSearch(&first, &last, tagPtr, &tSearch);
  717. if (TkBTreeCharTagged(&first, tagPtr)) {
  718.     TkTextPrintIndex(&first, position);
  719.     Tcl_AppendElement(interp, position);
  720. }
  721. while (TkBTreeNextTag(&tSearch)) {
  722.     TkTextPrintIndex(&tSearch.curIndex, position);
  723.     Tcl_AppendElement(interp, position);
  724. }
  725.     } else if ((c == 'r') && (strncmp(argv[2], "remove", length) == 0)
  726.     && (length >= 2)) {
  727. fullOption = "remove";
  728. addTag = 0;
  729. goto addAndRemove;
  730.     } else {
  731. Tcl_AppendResult(interp, "bad tag option "", argv[2],
  732. "": must be add, bind, cget, configure, delete, lower, ",
  733. "names, nextrange, raise, ranges, or remove",
  734. (char *) NULL);
  735. return TCL_ERROR;
  736.     }
  737.     return TCL_OK;
  738. }
  739. /*
  740.  *----------------------------------------------------------------------
  741.  *
  742.  * TkTextCreateTag --
  743.  *
  744.  * Find the record describing a tag within a given text widget,
  745.  * creating a new record if one doesn't already exist.
  746.  *
  747.  * Results:
  748.  * The return value is a pointer to the TkTextTag record for tagName.
  749.  *
  750.  * Side effects:
  751.  * A new tag record is created if there isn't one already defined
  752.  * for tagName.
  753.  *
  754.  *----------------------------------------------------------------------
  755.  */
  756. TkTextTag *
  757. TkTextCreateTag(textPtr, tagName)
  758.     TkText *textPtr; /* Widget in which tag is being used. */
  759.     CONST char *tagName; /* Name of desired tag. */
  760. {
  761.     register TkTextTag *tagPtr;
  762.     Tcl_HashEntry *hPtr;
  763.     int new;
  764.     hPtr = Tcl_CreateHashEntry(&textPtr->tagTable, tagName, &new);
  765.     if (!new) {
  766. return (TkTextTag *) Tcl_GetHashValue(hPtr);
  767.     }
  768.     /*
  769.      * No existing entry.  Create a new one, initialize it, and add a
  770.      * pointer to it to the hash table entry.
  771.      */
  772.     tagPtr = (TkTextTag *) ckalloc(sizeof(TkTextTag));
  773.     tagPtr->name = Tcl_GetHashKey(&textPtr->tagTable, hPtr);
  774.     tagPtr->toggleCount = 0;
  775.     tagPtr->tagRootPtr = NULL;
  776.     tagPtr->priority = textPtr->numTags;
  777.     tagPtr->border = NULL;
  778.     tagPtr->bdString = NULL;
  779.     tagPtr->borderWidth = 0;
  780.     tagPtr->reliefString = NULL;
  781.     tagPtr->relief = TK_RELIEF_FLAT;
  782.     tagPtr->bgStipple = None;
  783.     tagPtr->fgColor = NULL;
  784.     tagPtr->tkfont = NULL;
  785.     tagPtr->fgStipple = None;
  786.     tagPtr->justifyString = NULL;
  787.     tagPtr->justify = TK_JUSTIFY_LEFT;
  788.     tagPtr->lMargin1String = NULL;
  789.     tagPtr->lMargin1 = 0;
  790.     tagPtr->lMargin2String = NULL;
  791.     tagPtr->lMargin2 = 0;
  792.     tagPtr->offsetString = NULL;
  793.     tagPtr->offset = 0;
  794.     tagPtr->overstrikeString = NULL;
  795.     tagPtr->overstrike = 0;
  796.     tagPtr->rMarginString = NULL;
  797.     tagPtr->rMargin = 0;
  798.     tagPtr->spacing1String = NULL;
  799.     tagPtr->spacing1 = 0;
  800.     tagPtr->spacing2String = NULL;
  801.     tagPtr->spacing2 = 0;
  802.     tagPtr->spacing3String = NULL;
  803.     tagPtr->spacing3 = 0;
  804.     tagPtr->tabString = NULL;
  805.     tagPtr->tabArrayPtr = NULL;
  806.     tagPtr->underlineString = NULL;
  807.     tagPtr->underline = 0;
  808.     tagPtr->elideString = NULL;
  809.     tagPtr->elide = 0;
  810.     tagPtr->wrapMode = TEXT_WRAPMODE_NULL;
  811.     tagPtr->affectsDisplay = 0;
  812.     textPtr->numTags++;
  813.     Tcl_SetHashValue(hPtr, tagPtr);
  814.     return tagPtr;
  815. }
  816. /*
  817.  *----------------------------------------------------------------------
  818.  *
  819.  * FindTag --
  820.  *
  821.  * See if tag is defined for a given widget.
  822.  *
  823.  * Results:
  824.  * If tagName is defined in textPtr, a pointer to its TkTextTag
  825.  * structure is returned.  Otherwise NULL is returned and an
  826.  * error message is recorded in the interp's result unless interp
  827.  * is NULL.
  828.  *
  829.  * Side effects:
  830.  * None.
  831.  *
  832.  *----------------------------------------------------------------------
  833.  */
  834. static TkTextTag *
  835. FindTag(interp, textPtr, tagName)
  836.     Tcl_Interp *interp; /* Interpreter to use for error message;
  837.  * if NULL, then don't record an error
  838.  * message. */
  839.     TkText *textPtr; /* Widget in which tag is being used. */
  840.     CONST char *tagName; /* Name of desired tag. */
  841. {
  842.     Tcl_HashEntry *hPtr;
  843.     hPtr = Tcl_FindHashEntry(&textPtr->tagTable, tagName);
  844.     if (hPtr != NULL) {
  845. return (TkTextTag *) Tcl_GetHashValue(hPtr);
  846.     }
  847.     if (interp != NULL) {
  848. Tcl_AppendResult(interp, "tag "", tagName,
  849. "" isn't defined in text widget", (char *) NULL);
  850.     }
  851.     return NULL;
  852. }
  853. /*
  854.  *----------------------------------------------------------------------
  855.  *
  856.  * TkTextFreeTag --
  857.  *
  858.  * This procedure is called when a tag is deleted to free up the
  859.  * memory and other resources associated with the tag.
  860.  *
  861.  * Results:
  862.  * None.
  863.  *
  864.  * Side effects:
  865.  * Memory and other resources are freed.
  866.  *
  867.  *----------------------------------------------------------------------
  868.  */
  869. void
  870. TkTextFreeTag(textPtr, tagPtr)
  871.     TkText *textPtr; /* Info about overall widget. */
  872.     register TkTextTag *tagPtr; /* Tag being deleted. */
  873. {
  874.     if (tagPtr->border != None) {
  875. Tk_Free3DBorder(tagPtr->border);
  876.     }
  877.     if (tagPtr->bdString != NULL) {
  878. ckfree(tagPtr->bdString);
  879.     }
  880.     if (tagPtr->reliefString != NULL) {
  881. ckfree(tagPtr->reliefString);
  882.     }
  883.     if (tagPtr->bgStipple != None) {
  884. Tk_FreeBitmap(textPtr->display, tagPtr->bgStipple);
  885.     }
  886.     if (tagPtr->fgColor != None) {
  887. Tk_FreeColor(tagPtr->fgColor);
  888.     }
  889.     Tk_FreeFont(tagPtr->tkfont);
  890.     if (tagPtr->fgStipple != None) {
  891. Tk_FreeBitmap(textPtr->display, tagPtr->fgStipple);
  892.     }
  893.     if (tagPtr->justifyString != NULL) {
  894. ckfree(tagPtr->justifyString);
  895.     }
  896.     if (tagPtr->lMargin1String != NULL) {
  897. ckfree(tagPtr->lMargin1String);
  898.     }
  899.     if (tagPtr->lMargin2String != NULL) {
  900. ckfree(tagPtr->lMargin2String);
  901.     }
  902.     if (tagPtr->offsetString != NULL) {
  903. ckfree(tagPtr->offsetString);
  904.     }
  905.     if (tagPtr->overstrikeString != NULL) {
  906. ckfree(tagPtr->overstrikeString);
  907.     }
  908.     if (tagPtr->rMarginString != NULL) {
  909. ckfree(tagPtr->rMarginString);
  910.     }
  911.     if (tagPtr->spacing1String != NULL) {
  912. ckfree(tagPtr->spacing1String);
  913.     }
  914.     if (tagPtr->spacing2String != NULL) {
  915. ckfree(tagPtr->spacing2String);
  916.     }
  917.     if (tagPtr->spacing3String != NULL) {
  918. ckfree(tagPtr->spacing3String);
  919.     }
  920.     if (tagPtr->tabString != NULL) {
  921. ckfree(tagPtr->tabString);
  922.     }
  923.     if (tagPtr->tabArrayPtr != NULL) {
  924. ckfree((char *) tagPtr->tabArrayPtr);
  925.     }
  926.     if (tagPtr->underlineString != NULL) {
  927. ckfree(tagPtr->underlineString);
  928.     }
  929.     ckfree((char *) tagPtr);
  930. }
  931. /*
  932.  *----------------------------------------------------------------------
  933.  *
  934.  * SortTags --
  935.  *
  936.  * This procedure sorts an array of tag pointers in increasing
  937.  * order of priority, optimizing for the common case where the
  938.  * array is small.
  939.  *
  940.  * Results:
  941.  * None.
  942.  *
  943.  * Side effects:
  944.  * None.
  945.  *
  946.  *----------------------------------------------------------------------
  947.  */
  948. static void
  949. SortTags(numTags, tagArrayPtr)
  950.     int numTags; /* Number of tag pointers at *tagArrayPtr. */
  951.     TkTextTag **tagArrayPtr; /* Pointer to array of pointers. */
  952. {
  953.     int i, j, prio;
  954.     register TkTextTag **tagPtrPtr;
  955.     TkTextTag **maxPtrPtr, *tmp;
  956.     if (numTags < 2) {
  957. return;
  958.     }
  959.     if (numTags < 20) {
  960. for (i = numTags-1; i > 0; i--, tagArrayPtr++) {
  961.     maxPtrPtr = tagPtrPtr = tagArrayPtr;
  962.     prio = tagPtrPtr[0]->priority;
  963.     for (j = i, tagPtrPtr++; j > 0; j--, tagPtrPtr++) {
  964. if (tagPtrPtr[0]->priority < prio) {
  965.     prio = tagPtrPtr[0]->priority;
  966.     maxPtrPtr = tagPtrPtr;
  967. }
  968.     }
  969.     tmp = *maxPtrPtr;
  970.     *maxPtrPtr = *tagArrayPtr;
  971.     *tagArrayPtr = tmp;
  972. }
  973.     } else {
  974. qsort((VOID *) tagArrayPtr, (unsigned) numTags, sizeof (TkTextTag *),
  975.     TagSortProc);
  976.     }
  977. }
  978. /*
  979.  *----------------------------------------------------------------------
  980.  *
  981.  * TagSortProc --
  982.  *
  983.  * This procedure is called by qsort when sorting an array of
  984.  * tags in priority order.
  985.  *
  986.  * Results:
  987.  * The return value is -1 if the first argument should be before
  988.  * the second element (i.e. it has lower priority), 0 if it's
  989.  * equivalent (this should never happen!), and 1 if it should be
  990.  * after the second element.
  991.  *
  992.  * Side effects:
  993.  * None.
  994.  *
  995.  *----------------------------------------------------------------------
  996.  */
  997. static int
  998. TagSortProc(first, second)
  999.     CONST VOID *first, *second; /* Elements to be compared. */
  1000. {
  1001.     TkTextTag *tagPtr1, *tagPtr2;
  1002.     tagPtr1 = * (TkTextTag **) first;
  1003.     tagPtr2 = * (TkTextTag **) second;
  1004.     return tagPtr1->priority - tagPtr2->priority;
  1005. }
  1006. /*
  1007.  *----------------------------------------------------------------------
  1008.  *
  1009.  * ChangeTagPriority --
  1010.  *
  1011.  * This procedure changes the priority of a tag by modifying
  1012.  * its priority and the priorities of other tags that are affected
  1013.  * by the change.
  1014.  *
  1015.  * Results:
  1016.  * None.
  1017.  *
  1018.  * Side effects:
  1019.  * Priorities may be changed for some or all of the tags in
  1020.  * textPtr.  The tags will be arranged so that there is exactly
  1021.  * one tag at each priority level between 0 and textPtr->numTags-1,
  1022.  * with tagPtr at priority "prio".
  1023.  *
  1024.  *----------------------------------------------------------------------
  1025.  */
  1026. static void
  1027. ChangeTagPriority(textPtr, tagPtr, prio)
  1028.     TkText *textPtr; /* Information about text widget. */
  1029.     TkTextTag *tagPtr; /* Tag whose priority is to be
  1030.  * changed. */
  1031.     int prio; /* New priority for tag. */
  1032. {
  1033.     int low, high, delta;
  1034.     register TkTextTag *tagPtr2;
  1035.     Tcl_HashEntry *hPtr;
  1036.     Tcl_HashSearch search;
  1037.     if (prio < 0) {
  1038. prio = 0;
  1039.     }
  1040.     if (prio >= textPtr->numTags) {
  1041. prio = textPtr->numTags-1;
  1042.     }
  1043.     if (prio == tagPtr->priority) {
  1044. return;
  1045.     } else if (prio < tagPtr->priority) {
  1046. low = prio;
  1047. high = tagPtr->priority-1;
  1048. delta = 1;
  1049.     } else {
  1050. low = tagPtr->priority+1;
  1051. high = prio;
  1052. delta = -1;
  1053.     }
  1054.     for (hPtr = Tcl_FirstHashEntry(&textPtr->tagTable, &search);
  1055.     hPtr != NULL; hPtr = Tcl_NextHashEntry(&search)) {
  1056. tagPtr2 = (TkTextTag *) Tcl_GetHashValue(hPtr);
  1057. if ((tagPtr2->priority >= low) && (tagPtr2->priority <= high)) {
  1058.     tagPtr2->priority += delta;
  1059. }
  1060.     }
  1061.     tagPtr->priority = prio;
  1062. }
  1063. /*
  1064.  *--------------------------------------------------------------
  1065.  *
  1066.  * TkTextBindProc --
  1067.  *
  1068.  * This procedure is invoked by the Tk dispatcher to handle
  1069.  * events associated with bindings on items.
  1070.  *
  1071.  * Results:
  1072.  * None.
  1073.  *
  1074.  * Side effects:
  1075.  * Depends on the command invoked as part of the binding
  1076.  * (if there was any).
  1077.  *
  1078.  *--------------------------------------------------------------
  1079.  */
  1080. void
  1081. TkTextBindProc(clientData, eventPtr)
  1082.     ClientData clientData; /* Pointer to canvas structure. */
  1083.     XEvent *eventPtr; /* Pointer to X event that just
  1084.  * happened. */
  1085. {
  1086.     TkText *textPtr = (TkText *) clientData;
  1087.     int repick  = 0;
  1088. # define AnyButtonMask (Button1Mask|Button2Mask|Button3Mask
  1089. |Button4Mask|Button5Mask)
  1090.     Tcl_Preserve((ClientData) textPtr);
  1091.     /*
  1092.      * This code simulates grabs for mouse buttons by keeping track
  1093.      * of whether a button is pressed and refusing to pick a new current
  1094.      * character while a button is pressed.
  1095.      */
  1096.     if (eventPtr->type == ButtonPress) {
  1097. textPtr->flags |= BUTTON_DOWN;
  1098.     } else if (eventPtr->type == ButtonRelease) {
  1099. int mask;
  1100. switch (eventPtr->xbutton.button) {
  1101.     case Button1:
  1102. mask = Button1Mask;
  1103. break;
  1104.     case Button2:
  1105. mask = Button2Mask;
  1106. break;
  1107.     case Button3:
  1108. mask = Button3Mask;
  1109. break;
  1110.     case Button4:
  1111. mask = Button4Mask;
  1112. break;
  1113.     case Button5:
  1114. mask = Button5Mask;
  1115. break;
  1116.     default:
  1117. mask = 0;
  1118. break;
  1119. }
  1120. if ((eventPtr->xbutton.state & AnyButtonMask) == (unsigned) mask) {
  1121.     textPtr->flags &= ~BUTTON_DOWN;
  1122.     repick = 1;
  1123. }
  1124.     } else if ((eventPtr->type == EnterNotify)
  1125.     || (eventPtr->type == LeaveNotify)) {
  1126. if (eventPtr->xcrossing.state & AnyButtonMask)  {
  1127.     textPtr->flags |= BUTTON_DOWN;
  1128. } else {
  1129.     textPtr->flags &= ~BUTTON_DOWN;
  1130. }
  1131. TkTextPickCurrent(textPtr, eventPtr);
  1132. goto done;
  1133.     } else if (eventPtr->type == MotionNotify) {
  1134. if (eventPtr->xmotion.state & AnyButtonMask)  {
  1135.     textPtr->flags |= BUTTON_DOWN;
  1136. } else {
  1137.     textPtr->flags &= ~BUTTON_DOWN;
  1138. }
  1139. TkTextPickCurrent(textPtr, eventPtr);
  1140.     }
  1141.     if ((textPtr->numCurTags > 0) && (textPtr->bindingTable != NULL)
  1142.     && (textPtr->tkwin != NULL)) {
  1143. Tk_BindEvent(textPtr->bindingTable, eventPtr, textPtr->tkwin,
  1144. textPtr->numCurTags, (ClientData *) textPtr->curTagArrayPtr);
  1145.     }
  1146.     if (repick) {
  1147. unsigned int oldState;
  1148. oldState = eventPtr->xbutton.state;
  1149. eventPtr->xbutton.state &= ~(Button1Mask|Button2Mask
  1150. |Button3Mask|Button4Mask|Button5Mask);
  1151. TkTextPickCurrent(textPtr, eventPtr);
  1152. eventPtr->xbutton.state = oldState;
  1153.     }
  1154.     done:
  1155.     Tcl_Release((ClientData) textPtr);
  1156. }
  1157. /*
  1158.  *--------------------------------------------------------------
  1159.  *
  1160.  * TkTextPickCurrent --
  1161.  *
  1162.  * Find the character containing the coordinates in an event
  1163.  * and place the "current" mark on that character.  If the
  1164.  * "current" mark has moved then generate a fake leave event
  1165.  * on the old current character and a fake enter event on the new
  1166.  * current character.
  1167.  *
  1168.  * Results:
  1169.  * None.
  1170.  *
  1171.  * Side effects:
  1172.  * The current mark for textPtr may change.  If it does,
  1173.  * then the commands associated with character entry and leave
  1174.  * could do just about anything.  For example, the text widget
  1175.  * might be deleted.  It is up to the caller to protect itself
  1176.  * with calls to Tcl_Preserve and Tcl_Release.
  1177.  *
  1178.  *--------------------------------------------------------------
  1179.  */
  1180. void
  1181. TkTextPickCurrent(textPtr, eventPtr)
  1182.     register TkText *textPtr; /* Text widget in which to select
  1183.  * current character. */
  1184.     XEvent *eventPtr; /* Event describing location of
  1185.  * mouse cursor.  Must be EnterWindow,
  1186.  * LeaveWindow, ButtonRelease, or
  1187.  * MotionNotify. */
  1188. {
  1189.     TkTextIndex index;
  1190.     TkTextTag **oldArrayPtr, **newArrayPtr;
  1191.     TkTextTag **copyArrayPtr = NULL; /* Initialization needed to prevent
  1192.  * compiler warning. */
  1193.     int numOldTags, numNewTags, i, j, size;
  1194.     XEvent event;
  1195.     /*
  1196.      * If a button is down, then don't do anything at all;  we'll be
  1197.      * called again when all buttons are up, and we can repick then.
  1198.      * This implements a form of mouse grabbing.
  1199.      */
  1200.     if (textPtr->flags & BUTTON_DOWN) {
  1201. if (((eventPtr->type == EnterNotify) || (eventPtr->type == LeaveNotify))
  1202. && ((eventPtr->xcrossing.mode == NotifyGrab)
  1203. || (eventPtr->xcrossing.mode == NotifyUngrab))) {
  1204.     /*
  1205.      * Special case:  the window is being entered or left because
  1206.      * of a grab or ungrab.  In this case, repick after all.
  1207.      * Furthermore, clear BUTTON_DOWN to release the simulated
  1208.      * grab.
  1209.      */
  1210.     textPtr->flags &= ~BUTTON_DOWN;
  1211. } else {
  1212.     return;
  1213. }
  1214.     }
  1215.     /*
  1216.      * Save information about this event in the widget in case we have
  1217.      * to synthesize more enter and leave events later (e.g. because a
  1218.      * character was deleted, causing a new character to be underneath
  1219.      * the mouse cursor).  Also translate MotionNotify events into
  1220.      * EnterNotify events, since that's what gets reported to event
  1221.      * handlers when the current character changes.
  1222.      */
  1223.     if (eventPtr != &textPtr->pickEvent) {
  1224. if ((eventPtr->type == MotionNotify)
  1225. || (eventPtr->type == ButtonRelease)) {
  1226.     textPtr->pickEvent.xcrossing.type = EnterNotify;
  1227.     textPtr->pickEvent.xcrossing.serial = eventPtr->xmotion.serial;
  1228.     textPtr->pickEvent.xcrossing.send_event
  1229.     = eventPtr->xmotion.send_event;
  1230.     textPtr->pickEvent.xcrossing.display = eventPtr->xmotion.display;
  1231.     textPtr->pickEvent.xcrossing.window = eventPtr->xmotion.window;
  1232.     textPtr->pickEvent.xcrossing.root = eventPtr->xmotion.root;
  1233.     textPtr->pickEvent.xcrossing.subwindow = None;
  1234.     textPtr->pickEvent.xcrossing.time = eventPtr->xmotion.time;
  1235.     textPtr->pickEvent.xcrossing.x = eventPtr->xmotion.x;
  1236.     textPtr->pickEvent.xcrossing.y = eventPtr->xmotion.y;
  1237.     textPtr->pickEvent.xcrossing.x_root = eventPtr->xmotion.x_root;
  1238.     textPtr->pickEvent.xcrossing.y_root = eventPtr->xmotion.y_root;
  1239.     textPtr->pickEvent.xcrossing.mode = NotifyNormal;
  1240.     textPtr->pickEvent.xcrossing.detail = NotifyNonlinear;
  1241.     textPtr->pickEvent.xcrossing.same_screen
  1242.     = eventPtr->xmotion.same_screen;
  1243.     textPtr->pickEvent.xcrossing.focus = False;
  1244.     textPtr->pickEvent.xcrossing.state = eventPtr->xmotion.state;
  1245. } else  {
  1246.     textPtr->pickEvent = *eventPtr;
  1247. }
  1248.     }
  1249.     /*
  1250.      * Find the new current character, then find and sort all of the
  1251.      * tags associated with it.
  1252.      */
  1253.     if (textPtr->pickEvent.type != LeaveNotify) {
  1254. TkTextPixelIndex(textPtr, textPtr->pickEvent.xcrossing.x,
  1255. textPtr->pickEvent.xcrossing.y, &index);
  1256. newArrayPtr = TkBTreeGetTags(&index, &numNewTags);
  1257. SortTags(numNewTags, newArrayPtr);
  1258.     } else {
  1259. newArrayPtr = NULL;
  1260. numNewTags = 0;
  1261.     }
  1262.     /*
  1263.      * Resort the tags associated with the previous marked character
  1264.      * (the priorities might have changed), then make a copy of the
  1265.      * new tags, and compare the old tags to the copy, nullifying
  1266.      * any tags that are present in both groups (i.e. the tags that
  1267.      * haven't changed).
  1268.      */
  1269.     SortTags(textPtr->numCurTags, textPtr->curTagArrayPtr);
  1270.     if (numNewTags > 0) {
  1271. size = numNewTags * sizeof(TkTextTag *);
  1272. copyArrayPtr = (TkTextTag **) ckalloc((unsigned) size);
  1273. memcpy((VOID *) copyArrayPtr, (VOID *) newArrayPtr, (size_t) size);
  1274. for (i = 0; i < textPtr->numCurTags; i++) {
  1275.     for (j = 0; j < numNewTags; j++) {
  1276. if (textPtr->curTagArrayPtr[i] == copyArrayPtr[j]) {
  1277.     textPtr->curTagArrayPtr[i] = NULL;
  1278.     copyArrayPtr[j] = NULL;
  1279.     break;
  1280. }
  1281.     }
  1282. }
  1283.     }
  1284.     /*
  1285.      * Invoke the binding system with a LeaveNotify event for all of
  1286.      * the tags that have gone away.  We have to be careful here,
  1287.      * because it's possible that the binding could do something
  1288.      * (like calling tkwait) that eventually modifies
  1289.      * textPtr->curTagArrayPtr.  To avoid problems in situations like
  1290.      * this, update curTagArrayPtr to its new value before invoking
  1291.      * any bindings, and don't use it any more here.
  1292.      */
  1293.     numOldTags = textPtr->numCurTags;
  1294.     textPtr->numCurTags = numNewTags;
  1295.     oldArrayPtr = textPtr->curTagArrayPtr;
  1296.     textPtr->curTagArrayPtr = newArrayPtr;
  1297.     if (numOldTags != 0) {
  1298. if ((textPtr->bindingTable != NULL) && (textPtr->tkwin != NULL)) {
  1299.     event = textPtr->pickEvent;
  1300.     event.type = LeaveNotify;
  1301.     /*
  1302.      * Always use a detail of NotifyAncestor.  Besides being
  1303.      * consistent, this avoids problems where the binding code
  1304.      * will discard NotifyInferior events.
  1305.      */
  1306.     event.xcrossing.detail = NotifyAncestor;
  1307.     Tk_BindEvent(textPtr->bindingTable, &event, textPtr->tkwin,
  1308.     numOldTags, (ClientData *) oldArrayPtr);
  1309. }
  1310. ckfree((char *) oldArrayPtr);
  1311.     }
  1312.     /*
  1313.      * Reset the "current" mark (be careful to recompute its location,
  1314.      * since it might have changed during an event binding).  Then
  1315.      * invoke the binding system with an EnterNotify event for all of
  1316.      * the tags that have just appeared.
  1317.      */
  1318.     TkTextPixelIndex(textPtr, textPtr->pickEvent.xcrossing.x,
  1319.     textPtr->pickEvent.xcrossing.y, &index);
  1320.     TkTextSetMark(textPtr, "current", &index);
  1321.     if (numNewTags != 0) {
  1322. if ((textPtr->bindingTable != NULL) && (textPtr->tkwin != NULL)) {
  1323.     event = textPtr->pickEvent;
  1324.     event.type = EnterNotify;
  1325.     event.xcrossing.detail = NotifyAncestor;
  1326.     Tk_BindEvent(textPtr->bindingTable, &event, textPtr->tkwin,
  1327.     numNewTags, (ClientData *) copyArrayPtr);
  1328. }
  1329. ckfree((char *) copyArrayPtr);
  1330.     }
  1331. }