VectorImage::AddFragment

Adds a fragment to the VectorImage. A fragment is a VectorImage with a specified donor layer.

GSErrCode  AddFragment (
    GSPtr               fileRef,
    short               attribflag,
    short               layer,
    short               pen,
    short               drwIndex,
    short               ltype,
    short               fillind,
    double              dScale,
    TRANMAT*            tran
);

Parameters

filePlusId

A user-defined reference to a fragment.

attribflag

If not zero the fragment addition will use the specified pen, drwIndex, lineType and fillType attributes for the added fragment.

layer

The donor layer of the fragment. Only the items on this layer will be added to the image. It should range from 1 to 16.

pen

The drawing pen of the items from the fragment.

drwIndex

The drawing index of the items from the fragment. It influences the drawing order of the item.

ltype

The line type of the items from the fragment.

fillind

The fill type of the items from the fragment.

dScale

The default scale of the fragment.

tran

The applied transformation of the transfer.

Return value

If the function succeeds, the return value is NoError. If the function fails, the return value is the error code.

Description

Addition always merges the new item to the end of the primitives list but drawing order can differ from placing order.

Requirements

Version:API 10.0 or later, ModelerGraphics 8 or later

Library:ModelerGraphicsImp.lib (Win) or ModelerGraphics.framework (Mac)

Header:VectorImage.hpp