Table of Contents

Class SapItem

Namespace
Ranorex
Assembly
Ranorex.Plugin.Sap.dll

The element represents an item in a SAP data-bound control.

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

Constructors

SapItem()

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

protected SapItem()

SapItem(Element)

Creates a new SapItem adapter instance.

public SapItem(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

ColId

The id of the column this item is assigned to, if available.

public virtual string ColId { get; }

Property Value

string

Color

The color of the item, if available.

public virtual string Color { get; }

Property Value

string

Icon

The name of the icon assigned to this item.

public virtual string Icon { get; }

Property Value

string

ItemId

The id/key of the item, if available.

public virtual string ItemId { get; }

Property Value

string

RequiredCapabilities

Capabilities required by the adapter implementation.

protected override string[] RequiredCapabilities { get; }

Property Value

string[]

State

The current item state, such as selected or checked.

public virtual string State { get; }

Property Value

string

ToolTip

The tooltip text assigned to the item.

public virtual string ToolTip { get; }

Property Value

string

Type

The general type of the item.

public virtual string Type { get; }

Property Value

string

Methods

FromElement(Element)

Converts an Element to an instance of this class.

public static SapItem FromElement(Element element)

Parameters

element Element

The element to convert.

Returns

SapItem

The SapItem.

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 SapItem FromPath(string path)

Parameters

path string

The search path.

Returns

SapItem

The SapItem.

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.

PerformDoubleClick()

Performs a simulated mouse-doubleclick on the item if supported.

public virtual void PerformDoubleClick()

Exceptions

ActionFailedException

Thrown if invoking the action failed.

Operators

implicit operator SapItem(Element)

Implicitly converts an Element to an instance of this class.

public static implicit operator SapItem(Element element)

Parameters

element Element

The element to convert.

Returns

SapItem

The SapItem.

Exceptions

ArgumentNullException

If element is null.

CapabilityNotSupportedException

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

implicit operator SapItem(string)

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

public static implicit operator SapItem(string path)

Parameters

path string

The search path.

Returns

SapItem

The SapItem.

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.