You are here: Function Reference > Alphabetical Listing > C > ChangeLogo

ChangeLogo

Use this procedure/function to replace a bitmap graphic (LOG file) on a section with a different graphic.

Syntax

ChangeLogo (LOGFile, Graphic, Section, Form, Group)

Parameter	Description
LOGFile	Enter the name of a file that contains a valid graphic.
Graphic	Enter the name of the current graphic in a section.
Section	Enter the name of a section that contains the graphic you specified. The default is the current section.
Form	Enter the name of a form that contains the section or graphic. The default is the current form.
Group	Enter the name of a group to use to locate the object. The default is the current group.

The system optionally returns a one (1) if successful and zero (0) if unsuccessful.

This procedure expects to locate the named graphic in the same way and location used to load any other graphic. You must include the Graphic parameter.

If you omit the LOGFile parameter or the graphic cannot be loaded, the system will insert an empty graphic. A placeholder appears during entry to indicate the graphic position, however, nothing will print if a graphic is not loaded. This procedure lets you remove a signature from a form if necessary.

The Graphic parameter tells the system to look for the name that appears in the Name field on the Graphic Options in Studio. If there is no entry in this field, this procedure will not work correctly.

Note

When you use this procedure with Documaker Desktop, you must follow this procedure with the Refresh procedure. The ChangeLogo procedure does not redraw the section after it changes the graphic.
When you use the ChangeLogo procedure with Documaker, you must include the CheckImageLoaded rule as one of the section level rules for the section or else set the LoadCordFAP option in the RunMode control group to Yes in your FSISYS.INI file.

Example

Here are some examples:

(Assume the section has a graphic named sign.)

Procedure	Result	Explanation
ChangeLogo ( "johndoe", "sign")	1 or 0	Replaces the existing graphic contained by sign with a new graphic (johndoe). The existing graphic is assumed to exist in the current section.
ChangeLogo ( , "sign", "IMG")	1 or 0	Locate the specified section on the current form. If found replace the existing graphic contained by sign with an empty graphic.

ChangeLogo

Syntax

Note

Example

See also