GoFiler Legato Script Reference   Legato v 1.5d Application v 5.25a

Table of Contents	< < Previous	Next >>

 

Chapter Eighteen — DataView Integration (continued)

on_save

Overview

The on_save event is called as part of the save process. This is not a direct execution path to the save function but rather the call to write out the content of the view to a specified file.

Syntax/Parameters

Syntax

int on_save ( string filename ) { ... }

Parameters

filename

The filename to write the contents of the view. This is an intermediate filename.

Return Value

The function is expected to complete the process. An error code can be returned but is presently ignored.

Remarks

Upon completion the view will manage the file backup and save function. The filename may be a .~sav file. In such a case, to get the extension of the actual file, get the filename from the window. For example:

s1 = GetExtension(fnFile);
s1 = MakeLowerCase(s1);
if (s1 == ".~sav") {
  s1 = GetEditWindowFilename(hView);
  s1 = GetExtension(s1);
  s1 = MakeLowerCase(s1);
  }

 

Related Events and Functions

DataViewGetObject — Returns a Data View handle (for an associated sheet) for the specified view by window handle. Also locks for paint.

FormsViewSetSaveOptions — Sets options for the Save As dialog in Forms View.

GetEditWindowFilename — Returns the window filename for windows managed by the Edit Manager.

GetExtension — Gets the file extension with leading period. 

Page revised 2024-12-13

 

Table of Contents	< < Previous	Next >>

GoFiler Legato Script Reference — Generated on 12/16/2024

© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.