ui/gtk/range_utils.h

   1 /* range_utils.h
   2  * Declarations of utilities to with range_utils.c (packet range dialog)
   3  *
   4  * $Id$
   5  *
   6  * Ulf Lamping <ulf.lamping@web.de>
   7  *
   8  * Wireshark - Network traffic analyzer
   9  * By Gerald Combs <gerald@wireshark.org>
  10  * Copyright 1998 Gerald Combs
  11  *
  12  * This program is free software; you can redistribute it and/or
  13  * modify it under the terms of the GNU General Public License
  14  * as published by the Free Software Foundation; either version 2
  15  * of the License, or (at your option) any later version.
  16  *
  17  * This program is distributed in the hope that it will be useful,
  18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20  * GNU General Public License for more details.
  21  *
  22  * You should have received a copy of the GNU General Public License
  23  * along with this program; if not, write to the Free Software
  24  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  25  */
  26
  27 #ifndef __RANGE_UTILS_H__
  28 #define __RANGE_UTILS_H__
  29
  30 /** @file
  31  *  Packet range widget used for example in the "Save" and "Print" dialogs.
  32  */
  33
  34 /** Check the validity of a packet_range_t, and put up an alert box if
  35  ** it's not valid.
  36  *
  37  * @param range the range to check
  38  * @return a Boolean that's TRUE if it's valid and FALSE if it isn't
  39  */
  40 extern gboolean range_check_validity(packet_range_t *range);
  41
  42 /** Check the validity of a packet_range_t, and put up a modal alert box if
  43  ** it's not valid.
  44  *
  45  * @param parent the widget for the window that contained the range specification
  46  * @param range the range to check
  47  * @return a Boolean that's TRUE if it's valid and FALSE if it isn't
  48  */
  49 extern gboolean range_check_validity_modal(GtkWidget *parent, packet_range_t *range);
  50
  51 /** Create a new range widget.
  52  *
  53  * @param range the range to set
  54  * @param saving TRUE if range is selecting packets to save
  55  * @return the new range widget
  56  */
  57 extern GtkWidget *range_new(packet_range_t *range, gboolean saving);
  58
  59 /* Update all "dynamic" range things.
  60  *
  61  * @param data range widget
  62  */
  63 extern void range_update_dynamics(gpointer data);
  64
  65 #endif