snmdb_get_view manual page
Table of Contents

NAME

snmdb_get_view - reads the coordinates of the element in a particular view

SYNOPSIS

#include <netmgt/netmgt_db.h>

snmdb_get_view(buffer, viewname, x, y, z, x1, y1) snmdb_buffer *buffer;
char *viewname;
int *x;
int *y;
int *z;
int *x1;
int *y1;

DESCRIPTION

The membership records in the element buffer describe the x and y coordinate values of the element in the views, and whether the glyph of the element is stacked on top of another glyph (z value). snmdb_get_view retrieves the x and y coordinates in the membership record which describe the position of the element in view viewname. It also retrieves the z value, which is used when glyphs are stacked up on top of each other. If the element is of type bus.ethernet, as defined in elements.schema file, it will also retrieve the x1, y1 values of the end point position of the bus.

INPUT ARGUMENTS

buffer
pointer to a structure of type snmdb_buffer.

viewname
name of the view in which the element exists.

x
X coordinate of the element in the view.

y
Y coordinate of the element in the view.

z
Z value of the element in the view. This value is used when glyphs are stacked on top of each other.

x1 optional, used for an element of type bus.ethernet only, the X position of second end point of the bus element.

y1 optional, used for an element of type bus.ethernet only, the Y position of second end point of the bus element.

RETURN VALUE

Returns 1 if successful; otherwise, it returns 0. In case of an error, the external variable snm_error(3n) is set to the error reason.

FILES

elements.schema

SEE ALSO

snmdb_add_to_view(3n),
snmdb_delete_from_view(3n), snmdb_enumerate_views(3n)


Table of Contents