Returns a Proto object that represents the PROTO context (namespace) for the specified entity. Returns Nothing, if the entity is in the global context (isn't part of a PROTO declaration).

Deletes the specified entity.

If the entity is a named node, PROTO or field declaration, all references to the entity will also be deleted. If the entity definition contains declarations that have references outside the specified entity, all such references will be deleted as well.

The following Visual Basic example removes all routes to a node labeled "L1".

Dim r As Route For Each r In Document.Routes   If r.ToNode.Name = "L1" Then r.Delete Next

Returns a Document object that represents the VRML file contains the entity.

Returns the actual type of the specified entity from the enum of type VpEntityType.

Following are the possible values, which have the Long type:

EntityType	VRML object	Actual Type
vpNode = 1	Node definition	The Node object
vpNodeRef = 2	Node reference (USE)	The Node object
vpProto = 3	PROTO declaration	The Proto object
vpExternProto = 4	EXTERNPROTO declaration	The Proto object
vpField = 5	Node's field definition	The Field object
vpFieldDecl = 6	Script's or PROTO's field declaration	The Field object
vpProtoURL = 7	URL of EXTERNPROTO's declaration	The Field object
vpRoute = 8	ROUTE definition	The Route object
vpExpired = 0	Corresponding VRML object has been removed

When you need to cast an Entity object to a particular object type, you can use the Set statement in Visual Basic to set a variable of required type equal to the Entity object.

Dim ent As Entity Dim node As Node Set ent = Document.CurrentEntity If Not ent Is Nothing Then   If ent.EntityType = vpNode Then     Set node = ent     MsgBox node.TypeName   End If End If

In C++, you can use QueryInterface to get required interface.

Entity *pEnt; if (SUCCEEDED(pDoc->get_CurrentEntity(&pEnt)) && pEnt != NULL) {   Node *pNode;   if (SUCCEEDED(pEnt->QueryInterface(IID_Node, (void**) &pNode))) {     pNode->get_TypeName(&bstrName);     ...     pNode->Release();   }   pEnt->Release(); }

VBScript and JavaScript is typeless languages, so you don't have to do such conversion.

Dim ent Set ent = CurrentEntity If Not ent Is Nothing Then   If ent.EntityType = vpNode Then MsgBox ent.TypeName End If

Gets or sets the name of the entity.

The following table summarizes the results of using the Name property depending on value of the EntityType.

EntityType	Get Results	Set Results
vpNode	Gets the name of the node (by means of the DEF syntax). Returns empty string for the unnamed node.	Sets or changes the name of the node (and all references (USEs) of the node). The name must be unique in a PROTO context of the node. An empty string unnames the node.
vpNodeRef	Gets the name of the node (by means of the USE syntax).	inapplicable
vpProto vpExternProto	Gets the name of the PROTO or EXTERNPROTO declaration.	Renames the PROTO or EXTERNPROTO declaration.
vpField	Gets the name of the field definition.	inapplicable
vpFieldDecl	Gets the name of the script's or PROTO's field declaration.	Renames the field declaration (and all references of the field). The name must be unique in a scope of the node or PROTO header.
vpProtoURL	Gets the name of the EXTERNPROTO declaration.	inapplicable
vpRoute	inapplicable	inapplicable

Returns an Entity object that represents the immediate owner of the specified entity. Returns Nothing for the toplevel entities (root nodes and PROTOs).

The following example checks that two fields have the same scope.

Set field1 = ... Set field2 = ... If field1.Owner Is field2.Owner Then MsgBox "Same scope"

Returns a Range object that represents the portion of a document that's contained in the specified entity.

Flags (Optional)
Specifies the part of the entity text to include. Can be a combination of the following values from the enum of type VpEntityRange:

Value	Part of the entity
vprnAll = 0 (default)	All entity text with some whitespace padding
vprnId = 1	Typename of node, name of prototype declaration or field definition, source routed field name
vprnName = 2	Name of node (DEF), name of prototype declaration or field definition, source routed node name
vprnBody = 4	Body of node definition or prototype declaration (within braces), field value
vprnDecl = 8	Interface part (within square brackets) of prototype declaration, type of field declaration
vprnKeyword = 16	PROTO, DEF, USE, ROUTE, field, exposedField, eventIn, and eventOut keywords
vprnId2 = 32	Target routed field name
vprnName2 = 64	Target routed node name

For information about Range objects, see Using the Range Object.

Returns True if the specified entity is a standard VRML node type declaration or a field of that node.

A standard entity is a read-only object - you can't change name, delete or modify by other ways standard entities. You can't also get text range for the standard entity, because it has no associated text.

The following example checks that a node has a user-defined type (is a PROTO-instance).

Dim node As Node Set node = Document.Nodes("SomeNode") If Not node.Prototype.Standard Then   MsgBox node.Name & " is a PROTO instance" End If