Application

Windows and Launching

WaitForWindow and WaitForWindowRegex wait for a window by title and then take it as the window the selectors search, so a workflow can move to a window the launch never knew about. ResizeWindow and MoveWindow act on that window. Maximize, Minimize and Restore act on the application. WithNewInstance says to launch a new copy rather than attaching to one already running, which matters for any program that is always up: explorer.exe is the Windows shell, and Teams, Outlook and a browser are usually running before the workflow starts. Attaching to those hands back whatever window they already had and quietly drops the parameters Open was given.

NOTE

Some programs hand their work to something already running and exit at once. Opening a folder is the usual one: the process that starts takes the folder, passes it to the shell and quits, and the window that appears belongs to the shell. GPAL says so rather than treating it as a failure, and the window has to be found by name with WaitForWindow, which then becomes what the selectors search. A program that is still running but never showed a window is a real timeout and is reported as one.

Examples

GPAL Fluent: High-level fluent C# API

//WithWaitForWindowTimeout sets how long WaitForWindow, WaitForWindowRegex and the file dialog calls will wait. ResizeWindow and MoveWindow act on the window WaitForWindow settled on, so they follow it rather than the window the application started with.

// a program that is always running: launch, do not attach

IApplication explorer = GPAL.Application

.WithNewInstance(true)

.WithParameter(@"C:projects")

.Open(@"C:Windowsexplorer.exe")

.ToGPALObject();

// the launcher exited, so the window is found by name

explorer.WithWaitForWindowTimeout(10);

explorer

.WaitForWindowRegex("projects")

.ResizeWindow(1100, 700)

.MoveWindow(80, 80);

Documentation Example

Documentation

Showing off some plain text in these paragraphs eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Other formats

Here you can find different accents and emphasis sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

This is a link and how it could look like bestlinkinthebeautifulworld. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Here's just some classic bold text adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam notBoldSecondbestlinkinthebeautifulworld illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at adipisicing elit libero vel voluptas? Expedita, adipisicing facere dolores voluptatem ad ab rem assumenda soluta!

Other cuple of colors in case we want to emphasize several ways adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at voluptatem libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Adding Images to the content

Lorem ipsum dolor sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta! Lorem ipsum dolor, sit amet consectetur adipisicing elit. Quod veniam, quam ad expedita laborum sed at voluptates culpa ipsam ut vel. Ullam temporibus a mollitia quod aliquam ratione exercitationem nesciunt.

Coding Blocks

Lorem ipsum dolor sit amet consectetur adipisicing elit. Repudiandae quas consequuntur illo numquam assumenda autem exercitationem distinctio perspiciatis in natus. Eius dicta similique ipsam ipsa minima, nemo quae enim tempore.

GPAL

.CallIfNotFound(GenericCallIfNotFound)

.WithPublishToConsole();

//System.Drawing.Rectangle windowSize = new System.Drawing.Rectangle(10, 10, 1500, 1024);

// NOTE: we have to set browser = before we execute any steps

// this is due to the 'GenericCallIfNotFound' which might throw an exception, and BankScraper will not have the browser set when it calls scraper.Close()

// until the complete fluent line gets executed (meaning every step, meaning browser is not set until everything else succeeds)

browser = GPAL.Browser

.WithBrowserType(Enums.BrowserType.Chrome)

.WithProfileDataDirectory(ChromeProfileLocation)

.WithUseAutomationEngine(AutomationEngine.Selenium)

.WithWindowSize(new System.Drawing.Rectangle(0,0,1920,1080))

.ToGPALObject();

Application

Application

Windows and Launching

Examples

Documentation Example

Documentation

Category

Endpoint

Enpoint

Enpoint

Enpoint

Other formats

Adding Images to the content

Coding Blocks

On this page