---
name: "gk_userlist"
section: "3gk"
platform: "linux"
package: "groupkit"
version: "3.2-1"
release: "Debian 1.3 (Bo)"
platforms: ["linux"]
url: "https://new.carta.tech/gk_userlist"
---

# gk\_userlist(3gk)

display a list of users

## NAME

gk\_userlist - display a list of users

## SYNOPSIS

- **gk\_userlist** *pathname* ?*options*?

  ## DESCRIPTION

This widget is used to display a list of users inside a widget. Facilities exist for adding or deleting users from the list, and users are represented by an arbitrary Tk window, supplied by the caller. The widget is used internally by the gk\_participants(n) family  of widgets.

## WIDGET COMMAND

The **gk\_userlist** command creates a new Tcl command whose name is *pathname*.  This command may be used to invoke various operations on the widget.  The following commands are possible:

- *pathname* **adduser** *usernum win*

  Add a user to the list.  The user is (uniquely) identified by *usernum*, and is represented in the list by *win*, an arbitrary Tk window passed in by the caller.

- *pathname* **deluser** *usernum*

  Delete a user, identified by *usernum*, from the list.

- *pathname* **component** *identifier* ?*args...*?

  Return a subcomponent of the widget.  Currently, *identifier* can only have the value "user", in which case it must be followed by an argument specifying the usernum of a user in the list.  This will then return the pathname of the window representing the user.

## NOTE

This widget is built using the GroupKit class builder; see the GroupKit User Manual for more information.

## SEE ALSO

gk\_participants(n)

## AUTHOR

Shannon Jaeger (jaeger@cpsc.ucalgary.ca) and Mark Roseman (roseman@cpsc.ucalgary.ca)