AutomationElement.GetCurrentPropertyValue AutomationElement.GetCurrentPropertyValue AutomationElement.GetCurrentPropertyValue AutomationElement.GetCurrentPropertyValue Method

Definizione

Recupera il valore corrente della proprietà specificata da un oggetto AutomationElement.Retrieves the current value of the specified property from an AutomationElement.

Overload

GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty)

Recupera il valore della proprietà specificata su questo oggetto AutomationElement.Retrieves the value of the specified property on this AutomationElement. Viene restituito un valore predefinito adeguato al tipo di proprietà per le proprietà supportate in modo non esplicito dall'elemento dell'interfaccia utenteuser interface (UI) di destinazione.An appropriate default value for the property type is returned for properties not explicitly supported by the target interfaccia utenteuser interface (UI) element.

GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean)

Recupera il valore della proprietà specificata su questo oggetto AutomationElement, ignorando facoltativamente qualsiasi proprietà predefinita.Retrieves the value of the specified property on this AutomationElement, optionally ignoring any default property.

Commenti

Il valore restituito dal GetCurrentPropertyValue metodo è Current nel momento in cui viene chiamato.The value returned by the GetCurrentPropertyValue method is current at the time it is called. Il valore può essere modificato successivamente da altre applicazioni che interagiscono interfaccia utenteuser interface (UI)con il.The value can subsequently change by other applications interacting with the interfaccia utenteuser interface (UI).

Per alcune forme di Interfaccia utenteUI, questo metodo genererà un sovraccarico delle prestazioni tra processi.For some forms of Interfaccia utenteUI, this method will incur cross-process performance overhead. Le applicazioni possono concentrare l'overhead mediante la memorizzazione nella cache delle proprietà e GetCachedPropertyValuequindi il recupero tramite.Applications can concentrate overhead by caching properties and then retrieving them by using GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty) GetCurrentPropertyValue(AutomationProperty)

Recupera il valore della proprietà specificata su questo oggetto AutomationElement.Retrieves the value of the specified property on this AutomationElement. Viene restituito un valore predefinito adeguato al tipo di proprietà per le proprietà supportate in modo non esplicito dall'elemento dell'interfaccia utenteuser interface (UI) di destinazione.An appropriate default value for the property type is returned for properties not explicitly supported by the target interfaccia utenteuser interface (UI) element.

public:
 System::Object ^ GetCurrentPropertyValue(System::Windows::Automation::AutomationProperty ^ property);
public object GetCurrentPropertyValue (System.Windows.Automation.AutomationProperty property);
member this.GetCurrentPropertyValue : System.Windows.Automation.AutomationProperty -> obj
Public Function GetCurrentPropertyValue (property As AutomationProperty) As Object

Parametri

property
AutomationProperty AutomationProperty AutomationProperty AutomationProperty

Identificatore della proprietà di Automazione interfaccia utenteUI Automation che specifica la proprietà da recuperare.The Automazione interfaccia utenteUI Automation property identifier specifying which property to retrieve.

Restituisce

Oggetto contenente il valore della proprietà specificata.An object containing the value of the specified property.

Eccezioni

Esempi

Nell'esempio seguente viene recuperato il valore corrente della HelpText proprietà.The following example retrieves the current value of the HelpText property. Se l'elemento non ne fornisce uno, viene restituito il valore predefinito.The default value is returned if the element does not provide one.

// elementList is an AutomationElement.
string helpString =
    elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty) as string;
' elementList is an AutomationElement.
Dim helpString As String = _
    CStr(elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty))

Commenti

Il valore restituito dal GetCurrentPropertyValue metodo è Current nel momento in cui viene chiamato.The value returned by the GetCurrentPropertyValue method is current at the time it is called. Il valore può essere modificato successivamente da altre applicazioni che interagiscono Interfaccia utenteUIcon il.The value can subsequently change by other applications interacting with the Interfaccia utenteUI.

Se il provider di automazione interfaccia utente per l'elemento stesso supporta la proprietà, viene restituito il valore della proprietà.If the UI Automation provider for the element itself supports the property, the value of the property is returned. In caso contrario, viene restituita Automazione interfaccia utenteUI Automation una proprietà predefinita specificata da.Otherwise, a default property specified by Automazione interfaccia utenteUI Automation is returned. Per informazioni sulle proprietà predefinite, vedere i campi dell'identificatore di AutomationElementproprietà di, AcceleratorKeyPropertyad esempio.For information on default properties, see the property identifier fields of AutomationElement, such as AcceleratorKeyProperty.

Per alcune forme di Interfaccia utenteUI, questo metodo genererà un sovraccarico delle prestazioni tra processi.For some forms of Interfaccia utenteUI, this method will incur cross-process performance overhead. Concentrare l'overhead mediante la memorizzazione nella cache delle proprietà e quindi GetCachedPropertyValuerecuperarle usando.Concentrate overhead by caching properties and then retrieving them by using GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean) GetCurrentPropertyValue(AutomationProperty, Boolean)

Recupera il valore della proprietà specificata su questo oggetto AutomationElement, ignorando facoltativamente qualsiasi proprietà predefinita.Retrieves the value of the specified property on this AutomationElement, optionally ignoring any default property.

public:
 System::Object ^ GetCurrentPropertyValue(System::Windows::Automation::AutomationProperty ^ property, bool ignoreDefaultValue);
public object GetCurrentPropertyValue (System.Windows.Automation.AutomationProperty property, bool ignoreDefaultValue);
member this.GetCurrentPropertyValue : System.Windows.Automation.AutomationProperty * bool -> obj
Public Function GetCurrentPropertyValue (property As AutomationProperty, ignoreDefaultValue As Boolean) As Object

Parametri

property
AutomationProperty AutomationProperty AutomationProperty AutomationProperty

Identificatore della proprietà di Automazione interfaccia utenteUI Automation che specifica la proprietà da recuperare.The Automazione interfaccia utenteUI Automation property identifier specifying which property to retrieve.

ignoreDefaultValue
Boolean Boolean Boolean Boolean

Valore che specifica se un valore predefinito deve essere ignorato in caso di supporto della proprietà specificata.A value that specifies whether a default value should be ignored if the specified property is supported.

Restituisce

Oggetto contenente il valore della proprietà specificata o NotSupported se l'elemento non fornisce un valore e ignoreDefaultValue è true.An object containing the value of the specified property, or NotSupported if the element does not supply a value and ignoreDefaultValue is true.

Eccezioni

Esempi

Nell'esempio seguente viene recuperato il valore corrente della HelpText proprietà, ma viene specificato che se l'elemento stesso non fornisce un valore per la proprietà, NotSupported deve essere restituito invece di un valore predefinito.The following example retrieves the current value of the HelpText property, but specifies that if the element itself does not provide a value for the property, NotSupported is to be returned instead of a default value.

// elementList is an AutomationElement.
object help = elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty, true);
if (help == AutomationElement.NotSupported)
{
    help = "No help available";
}
string helpText = (string)help;
' elementList is an AutomationElement.
Dim help As Object = elementList.GetCurrentPropertyValue(AutomationElement.HelpTextProperty, True)
If help Is AutomationElement.NotSupported Then
    help = "No help available"
End If
Dim helpText As String = CStr(help)

Commenti

Il passaggio falseèequivalente alla chiamata AutomationElement.GetCurrentPropertyValue(AutomationProperty)a. ignoreDefaultValuePassing false in ignoreDefaultValue is equivalent to calling AutomationElement.GetCurrentPropertyValue(AutomationProperty).

Se il provider di automazione interfaccia utente per l'elemento stesso supporta la proprietà, viene restituito il valore della proprietà.If the UI Automation provider for the element itself supports the property, the value of the property is returned. In caso contrario ignoreDefaultValue , falsese è, viene restituita Automazione interfaccia utenteUI Automation una proprietà predefinita specificata da.Otherwise, if ignoreDefaultValue is false, a default property specified by Automazione interfaccia utenteUI Automation is returned. Per informazioni sulle proprietà predefinite, vedere i campi dell'identificatore di AutomationElementproprietà di, AcceleratorKeyPropertyad esempio.For information on default properties, see the property identifier fields of AutomationElement, such as AcceleratorKeyProperty.

Il valore restituito dal GetCurrentPropertyValue metodo è Current nel momento in cui viene chiamato.The value returned by the GetCurrentPropertyValue method is current at the time it is called. Il valore può essere modificato successivamente da altre applicazioni che interagiscono interfaccia utenteuser interface (UI)con il.The value can subsequently change by other applications interacting with the interfaccia utenteuser interface (UI).

Per alcune forme di Interfaccia utenteUI, questo metodo genererà un sovraccarico delle prestazioni tra processi.For some forms of Interfaccia utenteUI, this method will incur cross-process performance overhead. Le applicazioni possono concentrare l'overhead mediante la memorizzazione nella cache delle proprietà e GetCachedPropertyValuequindi il recupero tramite.Applications can concentrate overhead by caching properties and then retrieving them by using GetCachedPropertyValue.

Si applica a