virtual MgByteReader* MgDrawingService::DescribeDrawing

(

MgResourceIdentifier *

resource

)

[pure virtual]

Gets the manifest.xml document which describes the supported document interfaces, the document properties, the sections and their contents, and section dependencies.

.NET Syntax

virtual MgByteReader DescribeDrawing(MgResourceIdentifier resource);

Java Syntax

virtual MgByteReader DescribeDrawing(MgResourceIdentifier resource);

PHP Syntax

virtual MgByteReader DescribeDrawing(MgResourceIdentifier resource);

Parameters:

resource

(MgResourceIdentifier) Resource identifier specifying the drawing source which has the DWF resource data.

Returns:

Returns an MgByteReader object containing the manifest.xml file.

Example (PHP)

 // Assuming the drawing service has already been initialized
  $drawing_ID = new MgResourceIdentifier('Library://DrawingService/Floorplan.DrawingSource');
 $byteReader = $drawingService->DescribeDrawing($drawing_ID);

Exceptions:

MgInvalidCastException	if there are problems reading the DWF into memory.
MgServiceNotAvailableException	if the underlying resource service cannot be obtained to access the drawing in the resource repository.
MgXmlParserException	if there are problems parsing the resource content specified by the resource identifier.
MgInvalidDwfPackageException	if the DWF specified by the resource identifier is not a DWF of version 6.0 or greater.
MgDwfException	if the DWF component encounters errors.

Note:

See MgResourceService for additional exceptions.