*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> Vk/VkGetResource (3)              


VkGetResource(3x)					     VkGetResource(3x)

NAME    [Toc]    [Back]

     VkGetResource - Convenience functions for retrieving resources

HEADER FILE    [Toc]    [Back]

     #include <Vk/VkResource.h>

FUNCTIONS    [Toc]    [Back]

	   char	* VkGetResource(const char *name,
				const  char *className);

	   XtPointer VkGetResource(Widget w,
				   const char *names,
				   const char *classNames,
				   const char *desiredType,
				   const char *defaultValue);

DESCRIPTION    [Toc]    [Back]

	  These	functions provide simple ways to retrieve resources.  The
	  first	form retrieves a resource by name and class name from the
	  application's	resource database relative to the entire application.
	  The second form allows applications to retrieve a a resource
	  relative to a	specific widget. The resource can be specified as a
	  dot-separated	list of	names and classes, allowing "virtual" subresources
 to be retrieved.  The second form also allows a target
	  type to be specified.	 VkGetResource will convert the	retrieved
	  value, (or the default value if no value is retrieved), to the
	  specified type.

EXAMPLES    [Toc]    [Back]

	  Suppose an application wishes	to draw	an image and wishes to allow
	  the user to select various aspects of	the style in which the image
	  is drawn. For	example, each style might include a color and fill
	  pattern (a pixmap) with which	it is drawn.  Each aspect of each
	  style	could be specified as a	resource which could be	retrieved as

	   Widget shell	= XtAppInitialize(/* args */ );

	   Widget canvas = XmCreateDrawingArea(shell, "canvas",
					       NULL, 0);

	   Pixel fgOne = (Pixel) VkGetResource(canvas,
					 XmRString, "Black");

	   Pixel fgTwo = (Pixel) VkGetResource(canvas,
					  XmRString, "Black");

									Page 1

VkGetResource(3x)					     VkGetResource(3x)

	   Pixel fgThree = (Pixel) VkGetResource(canvas,
					   XmRString, "Black");

	   Pixel bgOne = (Pixel) VkGetResource(canvas,
					   XmRString, "White");

	   Pixel bgTwo = (Pixel) VkGetResource(canvas,
					  XmRString, "White");

	   Pixel bgThree = (Pixel) VkGetResource(canvas,
					   XmRString, "White");

	   Pixmap pixOne = (Pixmap) VkGetResource(canvas,
				       XmRString, "background");

	   Pixmap pixTwo = (Pixmap) VkGetResource(canvas,
				       XmRString, "background");

	   Pixmap pixThree = (Pixmap) VkGetResource(canvas,
					   XmRString, "background");

     These calls attempt to load a resource by the complete resource


     and so on.	All of the usual wild card uses	apply. Data returned by
     VkGetResource() should not	be freed.

SEE ALSO    [Toc]    [Back]

     ViewKit Programmer's Guide
     The X Window System, DEC Press, Bob Sheifler and Jim Gettys
     The X Window System Toolkit, DEC Press, Paul Asente and Ralph Swick
     The OSF/Motif Programmers Reference, Prentice Hall, OSF

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
XmRenditionUpdate HP-UX A convenience function that modifies resources
XmRenditionRetrieve HP-UX A convenience function that retrieves rendition resources
proplist Tru64 The storing, parsing, and retrieving of Extended File Attributes
iflDataSize IRIX convenience functions for using IFL data types
VkPixmap IRIX Convenience functions that work with libXpm
iflTypeNames IRIX convenience functions IFL enumerated types to strings
vn_write NetBSD high-level convenience functions for vnode operations
vn_stat NetBSD high-level convenience functions for vnode operations
vn_poll NetBSD high-level convenience functions for vnode operations
vn_read NetBSD high-level convenience functions for vnode operations
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service