Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.4j

Application v 5.22b

  

 

Chapter FifteenWindows/OS Functions (continued)

ClipboardGetApplication Function

Overview

The ClipboardGetApplication function retrieves the source application name, if available, for the application that last posted information to the clipboard.

Syntax/Parameters

Syntax

string = ClipboardGetApplication ( [handle hClipboard] );

Parameters

hClipboard

An optional handle specifying an open Clipboard Object. If not specified, or specified as NULL_HANDLE, if a Clipboard Object is open, it is automatically selected, and, if no object is open, a new object is opened and then closed upon completion of the function.

Return Value

Returns a string that contains a descriptive name of the source application or an empty string on error. An application code is also placed in the last error buffer. Use the GetLastError function to retrieve the application code or a formatted error code.

Remarks

The application name is an arbitrary string that is created by the host application after it examines the formats posted on the clipboard. This is used as a pattern signature to resolve certain common applications. If the application name cannot be determined, the executable name is added to the ‘Unknown Source (program.exe)’ string.

The application codes are defined in the SDK file LegatoDefault.h and are as follows:

  Definition   Bitwise   Comment/Description
  Format      
    CBA_KNOWN_APPLICATION   0x10000000   Known Application Flag
    CBA_SPREADSHEET   0x00008000   Application is a Spreadsheet
  Masks      
    CBA_VENDOR_MASK   0x00FF0000   Vendor Mask
    CBA_PRODUCT_MASK   0x00007F00   Product Mask
    CBA_VERSION_MASK   0x000000FF   Version Mask (Major/Minor) 00-unk
  Combination Masks      
    CBA_TYPE_MASK   0x10FF0000   Type (Known and Vendor Mask)
    CBA_APPLICATION_MASK   0x10FF7F00   Application (Known, Vendor, App Mask)
  Local Application      
    CBA_TYPE_APPLICATION   0x10000000   Local Application
    CBA_GOFILER   CBA_TYPE_APPLICATION + 0x0100   GoFiler
    CBA_PAGEPRIME   CBA_TYPE_APPLICATION + 0x0200   PagePrime
    CBA_PRIMEPAD   CBA_TYPE_APPLICATION + 0x0300   PrimePad
  Adobe      
    CBA_TYPE_ADOBE   0x10010000   Adobe
    CBA_ACROBAT   CBA_TYPE_ADOBE + 0x0100   Acrobat
    CBA_FIREWORKS   CBA_TYPE_ADOBE + 0x0200   Fireworks
    CBA_PAGEMAKER   CBA_TYPE_ADOBE + 0x0300   PageMaker
    CBA_INDESIGN   CBA_TYPE_ADOBE + 0x0400   InDesign
  Delta Graph      
    CBA_TYPE_DELTAGRAPH   0x10020000   Delta Graph
    CBA_DELTAGRAPH   CBA_TYPE_DELTAGRAPH + 0x0100   Delta Graph
  Google      
    CBA_TYPE_GOOGLE   0x10030000   Google
    CBA_CHROME   CBA_TYPE_GOOGLE + 0x0100   Firefox
  Microsoft      
    CBA_TYPE_MICROSOFT   0x10040000   Microsoft Applications w/ Window
    CBA_EXCEL   CBA_TYPE_MICROSOFT + 0x8100   Excel
    CBA_EXPLORER   CBA_TYPE_MICROSOFT + 0x0200   Explorer
    CBA_INTERNET_EXPLORER   CBA_TYPE_MICROSOFT + 0x0300   Internet Explorer
    CBA_NOTEPAD   CBA_TYPE_MICROSOFT + 0x0400   Notepad
    CBA_OUTLOOK   CBA_TYPE_MICROSOFT + 0x0500   Outlook
    CBA_PAINT   CBA_TYPE_MICROSOFT + 0x0600   Paint
    CBA_PHOTOEDITOR   CBA_TYPE_MICROSOFT + 0x0700   Photo Editor
    CBA_POWERPOINT   CBA_TYPE_MICROSOFT + 0x0800   Power Point
    CBA_WORD   CBA_TYPE_MICROSOFT + 0x0900   Word
    CBA_WORDPAD   CBA_TYPE_MICROSOFT + 0x0A00   WordPad
    CBA_WORKS_SPREADSHEET   CBA_TYPE_MICROSOFT + 0x8B00   Works SpreadSheet
    CBA_WORKS_WORD_PROCESSOR   CBA_TYPE_MICROSOFT + 0x0C00   Works Word Processor
    CBA_VISUAL_STUDIO   CBA_TYPE_MICROSOFT + 0x0D00   Visual Studio
  Mozilla      
    CBA_TYPE_MOZILLA   0x10050000   Mozilla
    CBA_FIREFOX   CBA_TYPE_MOZILLA + 0x0100   Firefox
  Opera      
    CBA_TYPE_OPERA   0x10060000   Opera Group
    CBA_OPERA   CBA_TYPE_OPERA + 0x0100   Opera Browser
  Quark      
    CBA_TYPE_QUARK   0x10070000   QuarkXpress
    CBA_QUARKXPRESS   CBA_TYPE_QUARK + 0x0100   QuarkXpress

 

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic