Smalltalk/X Webserver

Documentation of class 'AbstractLauncherApplication':

Class: AbstractLauncherApplication

Inheritance
Description
Class protocol
Instance protocol
Private classes

Inheritance:

   Object
   |
   +--Model
      |
      +--ApplicationModel
         |
         +--ToolApplicationModel
            |
            +--AbstractLauncherApplication
               |
               +--NewLauncher

Package:: stx:libtool

Category:: Interface-Smalltalk

Version:: rev: 1.620 date: 2024/03/19 11:52:47; user: cg; file: AbstractLauncherApplication.st directory: libtool; module: stx stc-classLibrary: libtool

Description:

This is an abstract class, providing mechanisms and common functionality
for launcher-type applications. Subclasses may implement their GUI either
with or without the UIPainter framework, and still use the common functions
provided here.

copyrightCOPYRIGHT (c) 1997 by eXept Software AG
             All Rights Reserved

This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice. This software may not
be provided or otherwise made available to, or used by, any
other person. No title to or ownership of the software is
hereby transferred.

Class protocol:

accessing

closeAllLaunchers

close all opened launchers

Usage example(s):

     self closeAllLaunchers.
     NewLauncher open

current

return the launcher running on the current screen.
(for access via addMenu/ removeMenu)

Usage example(s):

     NewLauncher current

openLaunchers

return all opened launchers

defaults

notifyingEmergencyHandler: return a block (used as an emergency handler
for exceptions), which does errorNotification before going
into the debugger.

image specs

communicationIcon

This resource specification was automatically generated
by the ImageEditor of ST/X.

Usage example(s):

     self communicationIcon inspect
     ImageEditor openOnClass:self andSelector:#communicationIcon
     Icon flushCachedIcons

cross2Icon

This resource specification was automatically generated
by the ImageEditor of ST/X.

Usage example(s):

     self cross2Icon inspect
     ImageEditor openOnClass:self andSelector:#cross2Icon
     Icon flushCachedIcons

httpServerIcon

systemBrowser24x24Icon

queries

isAbstract: Return if this class is an abstract class.
True is returned here for myself only; false for subclasses.
Abstract subclasses must redefine this again.

settings application list

addSettingsApplicationByClass: aClass withName: aName icon: anIcon: Ignore existing entries found in SettingsList for that name
allSettingsList
defaultSettingsApplicationList: cg: moved it to SettingsDialog - everyone is expecting it there and had to search it...
expandSettingsList: rawList: this expands a raw settings list,
by looking for entries with a block in their class name.
If any such is present, it is evaluated, returning
a collection of actual entries to use. Then, also % entries in
the name and icon are evaluated by sending corresponding messages
to the collected classes.
This allows for easy dynamic construction of more complicated
lists, for example to adapt to the set of loaded classes dynamically.
initializeSettingsList: self withAllSubclassesDo:[:cls | cls initializeSettingsList ]
removeSettingsApplicationByClass: aClass
removeSettingsEntry: entry forSettingsApp: aSettingsApp
settingsList: do NOT cache SettingsList
userSettingsList

settings dialog

openSettings
openSettingsAndSelect: selectedPageName
openSettingsFor: requestor
openSettingsFor: requestor andSelect: selectedPageName: settingsApp requestor:self.

utilities

openLoadPackageDialog: open a dialog showing wellknown packages (listed in the packages directory)
and offer to load the selected one(s).
TODO: make this a little app instead of an ad-hoc dialog,
add remote packages (central goody repository?)

open a dialog showing wellknown packages (listed in the packages directory)
and offer to load the selected one(s).
TODO: make this a little app instead of an ad-hoc dialog,
add remote packages (central goody repository?),
add a description text view, showing more info about the package (from where?)

saveImageAs: aFileName

save image in aFilename.
Sender has to handle SnapshotError

user actions-help

openDocumentation: open an HTML browser on the launcher section in the 'tools/TOP' document.
Called when <F1> is pressed
showBookPrintDocument: open an HTML browser on the 'book'-printing document
showCredits
showPortInfo
showRFC
showTipOfTheDay: open a tip-of-the-day window
startClassDocumentation: open an HTML browser on the 'classDoc/TOP' document
startDocumentationIndex: open an HTML browser on the 'index' document
startDocumentationTool: open an HTML browser on the 'TOP' document
startLauncherDocumentation: open an HTML browser on the launcher section in the 'tools/TOP' document
startProgrammersGuide: open an HTML browser on the 'programers guide' document
startSmalltalkSyntaxCheatSheet: open an HTML browser on the 'syntaxCheatSheet' document
startSmalltalkTutorial: open an HTML browser on 'doc\books\JoyOfST\IntroToST.html' document
startToolsDocumentation: open an HTML browser on the 'tools/TOP' document
startTutorial: open an HTML browser on the 'getstart/tutorial.html' document
startWhatsNewDocumentation: open an HTML browser on the 'whatsNew.html' document
startWhatsNewSTX: open an HTML browser on the 'relNotes.html' document

user actions-system

compressingGarbageCollect: perform a compressing garbageCollect
flushCachedResources: flush all cached resources (e.g. translations).
garbageCollect: perform a non-compressing garbageCollect
objectModuleDialog: opens a moduleInfo dialog
startStopEventTrace: start/stop event tracing for a particular view

user actions-tools

inspectGlobalVariables: inspect globals
inspectWorkspaceVariables: inspect workspace variables
newProject: creates a new project & opens a projectView for it
openEvaluationWorkspace
openMyWorkspace
openRegularWorkspace
openScriptingWorkspace
openSystemWorkspace
openTerminal
openTextDiffTool
openWorkspace
removeAllWorkspaceVariables: remove workspace variables
selectProject: asks for and switch to another project
startBugMessages: open the bug reporter
startChangeSetBrowser: open a change Set Browser on the changes in the system
startChangesBrowser: open a changebrowser on the change file - either new or old GUI, depending on userPrefs
startInternationalLanguageTranslationEditor: open the language-string editor (english/german/spanish etc.)
startNewChangesBrowser: opens the new changeBrowser
startNewLauncher: opens the new launcher
startOldChangesBrowser: opens the old changeBrowser
startOldLauncher: opens the old launcher
startSUnitTestRunner: open the configured SUnit test runner
startSUnitTestRunner1: open the SUnit test runner
startSmaCCParserGenerator: open the SmaCC-ParserGenerator UI

user actions-windows

allTopViewsDo: aBlock

askForAnotherDisplay

ask for some other display

bringAllWindowsOntoScreen

shift & resize all views to be visible.
If there are multiple screens, bring them all onto the screen where the launcher is

Usage example(s):

     Transcript topView application bringAllWindowsOntoScreen

bringWindow: aWindow intoBounds: bounds

shift & resize a view to be completely inside bounds.

bringWindowOntoScreen: aWindow

shift & resize a view to be visible.
If there are multiple screens, bring it onto the screen where the launcher is

deIconifyAllWindows

Transcript topView application deIconifyAllWindows

findAndDestroyWindow

find a window (by name) and destroy it

findAndInspectWindow

find a window (by name) and inspect it

findAndMigrateWindow

find a window (by name) and migrate it to some other display

findAndMigrateWindowBack

find a window (by name) and migrate it back to this display

findAndRaiseWindow

find a window (by name) and raise it

fullScreenHardcopy

after a second (to allow redraw of views under menu ...),
save the contents of the whole screen.

fullScreenHardcopyUngrabbed

after a second (to allow redraw of views under menu ...),
save the contents of the whole screen.

hardcopyOfView: aView

after a second (to allow redraw of views under menu ...),
save a view's contents as bitmap image.

iconifyAllWindows

migrateAllWindows

migrate all views to some other display

migrateAllWindowsToDisplay

migrate all views to the current display

migrateAllWindowsToDisplay: aDisplay

migrate all views to some other display

migrateWindow: aWindow

migrate a view to some other display

migrateWindow: aWindow withBackOption: withBackOption

migrate a view to some other display

openWindowTreeInspector

screenHardcopy

let user specify a rectangular area on the screen,
then after a second (to allow redraw of views under menu ...),
save its contents.

screenHardcopyAfter: delay withCircle: withCircle

after a delay (to allow redraw of views under menu ...),
let user specify a rectangular area on the screen (which is copied),
and optionally another area (which gets an ellipse drawn inside)
and save its contents to a file.

screenHardcopyWithCircle

let user specify a rectangular area on the screen, then a circled area,
then after a second (to allow redraw of views under menu ...),
save its contents.

screenHardcopyWithDelay

let user specify a rectangular area on the screen,
then, after some time (to allow user to pull menu or similar...),
save its contents.

showFlyByWindowInformation

show infos about window under the mouse pointer

startWindowTreeView

open a windowTree (on a picked topView)

startWindowTreeViewForAll

open a windowTree on all views in the system

viewBrowse

let user pick a view and browse its Application class.
Of course, only Smalltalk views are allowed

viewDestroy

let user pick a view and destroy it.
Even allow destroying non-Smalltalk views
(also for views which I forgot due to some error)

viewHardcopy

after a second (to allow redraw of views under menu ...),
let user specify a view and save its contents.

viewHardcopyAfter: delayTime

after a second (to allow redraw of views under menu ...),
let user specify a view and save its contents.

viewHardcopyWithDelay

after 5 seconds,
let user specify a view and save its contents.

viewInspect

let user pick a view and inspect it.
Of course, only Smalltalk views are allowed

viewMigrate

let user pick a view and migrate it to some other display.
Only Smalltalk views are allowed

viewSelectAndShrink

let user pick a view and shrink it to a reasonable size
Added for stupid mac, to get windows back onto the screen,
which have their resize handle hidden or unreachable.

widgetHardcopy

after a second (to allow redraw of views under menu ...),
let user specify a widget and save its contents.

Private classes:

    LauncherDialogs
    PackageLoadDialog

ST/X 7.7.0.0; WebServer 1.702 at 20f6060372b9.unknown:8081; Tue, 31 Dec 2024 01:52:20 GMT

Smalltalk/X Webserver

Documentation of class 'AbstractLauncherApplication':

Class: AbstractLauncherApplication

Inheritance:

Description:

copyright

Class protocol:

Instance protocol:

Private classes: