Technical Reference > Graphics Builder Automation Interface > Metadata Functions > PropertiesSelectMetadataByName

PropertiesSelectMetadataByName

Selects the specified metadata in the current page.

Syntax

PropertiesSelectMetadataByName(BSTR Name)

Name:

The name of the metadata to be selected.

Return Value

0 (zero) if successful, otherwise an error is returned.

Example

Determining whether an metadata with a particular name exists:

On Error Resume Next
Err.Clear()
GraphicsBuilder.PropertiesSelectMetadataByName("MyName")
If (Err.Number <> 0)
	' The metadata does not exist
End If

Related Functions

PropertiesDeleteMetadata, PropertiesMetadataValue, PropertiesMetadataName, PropertiesSelectNextMetadata, PropertiesSelectFirstMetadata