VectorImage::Append

Appends the VectorImage with the drawing primitives of the donor VectorImage.

GSErrCode  Append (
    const VectorImage&  donorImage,
    const TRANMAT&      tran,
    bool                useExternalAttribs = false,
    short               actLayer = 0,
    short               actPen   = 0,
    short               actLType = 0
);

Parameters

donorImage

The image which drawing primitives copied into the current VectorImage.

tran

The transformation applied all the copied drawing primitives.

useExternalAttribs

True if the following attributes should taken into account.

actLayer

The layer index which the new items will belong to, if the useExternalAttribs is true.

actPen

The pen index which the new items will use, if the useExternalAttribs is true.

actLType

The line type index which the new items will use, if the useExternalAttribs is true.

Return value

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

Description

Appends the VectorImage with the drawing primitives of the donor VectorImage.

Requirements

Version:API 10.0 or later, ModelerGraphics 8 or later

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

Header:VectorImage.hpp