setpup Subroutine

GL3.2 for AIX: Graphics Library (GL) Technical Reference

setpup Subroutine

Purpose

Enables or disables a given pop-up menu entry.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void setpup (Int32 pup, Int 32 entry, Int32 mode)

FORTRAN Syntax

SUBROUTINE SETPUP (pup, entry, mode)

INTEGER*4 pup, entry, mode

Description

The setpup subroutine enables or disables a given pop-up menu entry. Disabled pop-up menu entries are greyed out and cannot be chosen or selected. When an entry is disabled, the dopup subroutine does not return the value of the disabled entry. If the setpup subroutine is used properly, submenus associated with the disabled entry are also not accessible.

Enabled entries operate as normal.

Note: This subroutine cannot be added to a display list.

Parameters

pup

Specifies the pop-up menu containing the entry to be enabled or disabled.

entry

Specifies the cardinal number of the entry to be disabled (use 1 for the first entry, 2 for the second entry, and so on).

mode

Sets the mode for the specified menu entry:

C	FORTRAN	Description
PUP_NONE	PUPNON	Enables a menu entry.
PUP_GREY	PUPGRE	Disables a menu entry.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

Files

/usr/include/gl/gl.h	Contains C language constant and variable type definitions for GL.
/usr/include/gl/fgl.h	Contains FORTRAN constant and variable type definitions for GL.

Related Information

Adding an item to an existing pop-up menu with the addtopup subroutine.

Defining a pop-up menu with the defpup subroutine.

Displaying a pop-up menu with the dopup subroutine.

Allocating and initializing a structure for a new pop-up menu with the newpup subroutine.

AIX Graphics Library Overview and Creating and Managing Pop-Up Menus.