Open Inventor Reference
SoWWWAnchor.h
Go to the documentation of this file.
1 /*
2  *
3  * Copyright (C) 2000 Silicon Graphics, Inc. All Rights Reserved.
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2.1 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  * Lesser General Public License for more details.
14  *
15  * Further, this software is distributed without any warranty that it is
16  * free of the rightful claim of any third person regarding infringement
17  * or the like. Any license provided herein, whether implied or
18  * otherwise, applies only to this software file. Patent licenses, if
19  * any, provided herein do not apply to combinations of this program with
20  * other software, or any other product whatsoever.
21  *
22  * You should have received a copy of the GNU Lesser General Public
23  * License along with this library; if not, write to the Free Software
24  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25  *
26  * Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
27  * Mountain View, CA 94043, or:
28  *
29  * http://www.sgi.com
30  *
31  * For further information regarding this notice, see:
32  *
33  * http://oss.sgi.com/projects/GenInfo/NoticeExplan/
34  *
35  */
36 
37 
38 /*
39  *
40  _______________________________________________________________________
41  ______________ S I L I C O N G R A P H I C S I N C . ____________
42  |
43  | $Revision: 1.1.1.1 $
44  |
45  | Description:
46  | Defines the SoWWWAnchor class
47  |
48  | Author(s): David Mott, Jim Kent, Gavin Bell
49  |
50  ______________ S I L I C O N G R A P H I C S I N C . ____________
51  _______________________________________________________________________
52  */
53 
54 #ifndef _SO_WWWANCHOR_
55 #define _SO_WWWANCHOR_
56 
59 
60 class SoWWWAnchor;
61 
67  const SbString &url, void *userData, SoWWWAnchor *node);
68 
69 
70 
73 
92 
94 
96 
97  public:
98 
101 
102  enum Mapping {
104  POINT
105  };
106 
108 
109 
114 
118 
128 
130 
132  void setFullURLName(const SbString &url) { fullURL = url; }
140 
144  static void setFetchURLCallBack(
145  SoWWWAnchorCB *f, void *userData);
146 
151  SoWWWAnchorCB *f, void *userData);
152 
153  SoEXTENDER public:
156  virtual void handleEvent(SoHandleEventAction *action);
157 
158  SoINTERNAL public:
159  static void initClass();
160 
161  protected:
162  virtual ~SoWWWAnchor();
163 
166  virtual void redrawHighlighted(SoAction *act, bool isNowHighlighting);
167 
169  static void *fetchURLdata;
171  static void *highlightURLdata;
173 
174  private:
175  SbString fullURL;
176 };
177 
178 #endif /* _SO_WWWANCHOR_ */
#define SoEXTENDER
Provide inline template functions for abs, swap, min, max, and clamp.
Definition: SbBasic.h:154
#define SoINTERNAL
Definition: SbBasic.h:155
#define INVENTOR_API
Disable some annoying warnings on MSVC 6.
Definition: SbSystem.h:81
#define SO_NODE_HEADER(className)
Non-abstract classes have everything abstract classes have, plus a way to create an instance.
Definition: SoSubNode.h:170
void INVENTOR_API SoWWWAnchorCB(const SbString &url, void *userData, SoWWWAnchor *node)
This is the format for callbacks during anchor activation (left mouse click) and highlight (move over...
Definition: SoWWWAnchor.h:66
Class for smart character strings.
Definition: SbString.h:85
Abstract base class for all actions.
Definition: SoAction.h:179
Allows nodes in a graph to receive input events.
Special separator that performs locate highlighting.
Field containing an enumerated value.
Definition: SoSFEnum.h:93
Field containing a string.
Definition: SoSFString.h:88
Separator group node with a URL hyperlink.
Definition: SoWWWAnchor.h:93
SoSFEnum map
Specifies what additional information should be added to the end of the URL when passed back to the a...
Definition: SoWWWAnchor.h:127
static void * highlightURLdata
Definition: SoWWWAnchor.h:171
static void setHighlightURLCallBack(SoWWWAnchorCB *f, void *userData)
Application callbacks invoked when the mouse is moved over an anchor so that the app can provide feed...
@ NONE
Do no add information to the URL.
Definition: SoWWWAnchor.h:103
static SoWWWAnchorCB * fetchURLcb
Definition: SoWWWAnchor.h:168
static void initClass()
virtual ~SoWWWAnchor()
SoSFString description
A description of the URL which may make more sense to users than the URL itself (e....
Definition: SoWWWAnchor.h:117
virtual void redrawHighlighted(SoAction *act, bool isNowHighlighting)
redefine this to also invoke the app callbacks...
static void * fetchURLdata
Definition: SoWWWAnchor.h:169
SoSFString name
URL which the application will be called back to fetch when this node is activated by a left mouse cl...
Definition: SoWWWAnchor.h:113
void setFullURLName(const SbString &url)
Definition: SoWWWAnchor.h:132
virtual void handleEvent(SoHandleEventAction *action)
Override handleEvent to look for left-mouse clicks, to do a pick:
static SoWWWAnchorCB * highlightURLcb
Definition: SoWWWAnchor.h:170
static SbString emptyString
Definition: SoWWWAnchor.h:172
SoWWWAnchor()
Creates an anchor node with default settings.
static void setFetchURLCallBack(SoWWWAnchorCB *f, void *userData)
Application callbacks invoked when the mouse is clicked on an anchor so that the application can fetc...
const SbString & getFullURLName()
If the name field contains a relative URL (e.g.