Table of Contents

Class SapWindow

Namespace
Ranorex
Assembly
Ranorex.Plugin.Sap.dll

The element represents a top-level window of a SAP GUI application.

public class SapWindow : Adapter, IAdapter
Inheritance
SapWindow
Implements
Inherited Members

Constructors

SapWindow()

Creates a new SapWindow adapter instance. This constructor is used internally by the Ranorex Core Framework for performance issues!

protected SapWindow()

SapWindow(Element)

Creates a new SapWindow adapter instance.

public SapWindow(Element element)

Parameters

element Element

The element to create the adapter for.

Exceptions

NullReferenceException

If element is null.

CapabilityNotSupportedException

If the element does not support the capabilities required by this adapter.

Properties

ApplicationServer

The host name of the SAP application server.

public virtual string ApplicationServer { get; }

Property Value

string

Busy

Determines whether the server/transaction is currently busy processing.

public virtual bool Busy { get; }

Property Value

bool

CodePage

The code page used for the connection.

public virtual string CodePage { get; }

Property Value

string

ConnectionDescription

The SAP connection description supplied by the user.

public virtual string ConnectionDescription { get; }

Property Value

string

ConnectionString

The SAP server connection string.

public virtual string ConnectionString { get; }

Property Value

string

Language

The currently active language for the connection to the SAP system.

public virtual string Language { get; }

Property Value

string

Program

The name of the program used to connect to the SAP system.

public virtual string Program { get; }

Property Value

string

RequiredCapabilities

Capabilities required by the adapter implementation.

protected override string[] RequiredCapabilities { get; }

Property Value

string[]

SystemName

The name of the connected SAP system.

public virtual string SystemName { get; }

Property Value

string

TestToolMode

Determines whether the SAPGUI is in test tool mode.

public virtual bool TestToolMode { get; }

Property Value

bool

Transaction

The currently running SAP transaction.

public virtual string Transaction { get; }

Property Value

string

UserName

The user name used to log on to the SAP system.

public virtual string UserName { get; }

Property Value

string

Version

The SAPGUI version number.

public virtual string Version { get; }

Property Value

string

Methods

FromElement(Element)

Converts an Element to an instance of this class.

public static SapWindow FromElement(Element element)

Parameters

element Element

The element to convert.

Returns

SapWindow

The SapWindow.

Exceptions

ArgumentNullException

If element is null.

CapabilityNotSupportedException

If the element does not support the capabilities required by this adapter.

FromPath(string)

Converts a string to an instance of this class by searching the root.

public static SapWindow FromPath(string path)

Parameters

path string

The search path.

Returns

SapWindow

The SapWindow.

Remarks

The DefaultSearchTimeout is used to search for the specified path.

Exceptions

ArgumentNullException

If path is null.

RxPathException

If the specified path is not valid.

ElementNotFoundException

If no element is found.

CapabilityNotSupportedException

If the element does not support the capabilities required by this adapter.

Operators

implicit operator SapWindow(Element)

Implicitly converts an Element to an instance of this class.

public static implicit operator SapWindow(Element element)

Parameters

element Element

The element to convert.

Returns

SapWindow

The SapWindow.

Exceptions

ArgumentNullException

If element is null.

CapabilityNotSupportedException

If the element does not support the capabilities required by this adapter.

implicit operator SapWindow(string)

Implicitly converts a string to an instance of this class by searching the root.

public static implicit operator SapWindow(string path)

Parameters

path string

The search path.

Returns

SapWindow

The SapWindow.

Remarks

The DefaultSearchTimeout is used to search for the specified path.

Exceptions

ArgumentNullException

If path is null.

RxPathException

If the specified path is not valid.

ElementNotFoundException

If no element is found.

CapabilityNotSupportedException

If the element does not support the capabilities required by this adapter.