#         Portable Batch System (PBS) Software License
# 
# Copyright (c) 1999, MRJ Technology Solutions.
# All rights reserved.
# 
# Acknowledgment: The Portable Batch System Software was originally developed
# as a joint project between the Numerical Aerospace Simulation (NAS) Systems
# Division of NASA Ames Research Center and the National Energy Research
# Supercomputer Center (NERSC) of Lawrence Livermore National Laboratory.
# 
# Redistribution of the Portable Batch System Software and use in source
# and binary forms, with or without modification, are permitted provided
# that the following conditions are met:
# 
# - Redistributions of source code must retain the above copyright and
#   acknowledgment notices, this list of conditions and the following
#   disclaimer.
# 
# - Redistributions in binary form must reproduce the above copyright and 
#   acknowledgment notices, this list of conditions and the following
#   disclaimer in the documentation and/or other materials provided with the
#   distribution.
# 
# - All advertising materials mentioning features or use of this software must
#   display the following acknowledgment:
# 
#   This product includes software developed by NASA Ames Research Center,
#   Lawrence Livermore National Laboratory, and MRJ Technology Solutions.
# 
#         DISCLAIMER OF WARRANTY
# 
# THIS SOFTWARE IS PROVIDED BY MRJ TECHNOLOGY SOLUTIONS ("MRJ") "AS IS" WITHOUT 
# WARRANTY OF ANY KIND, AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,
# BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS
# FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT ARE EXPRESSLY DISCLAIMED.
# 
# IN NO EVENT, UNLESS REQUIRED BY APPLICABLE LAW, SHALL MRJ, NASA, NOR
# THE U.S. GOVERNMENT BE LIABLE FOR ANY DIRECT DAMAGES WHATSOEVER,
# NOR ANY INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
# USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
# 
# This license will be governed by the laws of the Commonwealth of Virginia,
# without reference to its choice of law rules.
################################################################################
# This file contains all procedures related to a text widgets.
################################################################################
# buildFullTextbox: creates a text widget on 'frame_name' of 'ColxRow' 
#	dimensions (in chars), with a 'scrollbar' type of either "yscroll" or
#	"noscroll".
# OPTIONS:
#	text_title - if you choose to puts a label string on the text widget.
proc buildFullTextbox {frame_name ColxRow scrollbarType {text_title ""} } {

  global BADPARAM errmsg TEXTFONT LABELFONT
  set procname "buildFull_Textbox"

## Let's be defensive about the input
  if { ![regexp "\\." $frame_name] || \
        ![regexp "(\[0-9]+)x(\[0-9]+)" $ColxRow match Col Row] || \
        ([string compare $scrollbarType  "yscroll"] != 0 &&  \
	 [string compare $scrollbarType  "noscroll"] != 0) } {
        puts "Error $BADPARAM in $procname: $errmsg(BADPARAM)"
	exit $BADPARAM
  }
  if { [string compare $frame_name "." ] == 0 } {
	set frame_name ""
  }
  text $frame_name.textbox 	-borderwidth 2 \
			        -relief groove \
			        -setgrid 1 \
                                -font $TEXTFONT  \
				-exportselection true \
			        -width $Col  \
			        -height $Row \
				-wrap word

  bind_text_overselect $frame_name.textbox

  if {[string compare $text_title ""] != 0} {
    label $frame_name.label -text $text_title -font $LABELFONT	
    pack  $frame_name.label -anchor nw -side left -fill x -expand 1
    pack  $frame_name.textbox -after $frame_name.label -anchor nw -side left \
	  -fill both -expand 1
  } else {
    pack $frame_name.textbox -anchor nw -side left -expand 1 -fill both 
  }

  set scrollbars ""
  if { [string compare $scrollbarType "yscroll"] == 0 } {
       scrollbar $frame_name.vscroll -command "$frame_name.textbox yview" \
                                     -borderwidth 2 \
                                     -orient vertical \
                                     -relief groove
       $frame_name.textbox configure -yscrollcommand "$frame_name.vscroll set"
       pack $frame_name.vscroll  -anchor se -fill y -expand 1 -side right \
        		         -after $frame_name.textbox -expand 1
      set scrollbars $frame_name.vscroll
  }

  return [concat $frame_name $frame_name.textbox $scrollbars]
}
