AutomationElement.GetCurrentPropertyValue Metodo

Definizione

Spazio dei nomi:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Recupera il valore corrente della proprietà specificata da un oggetto AutomationElement.

Overload

GetCurrentPropertyValue(AutomationProperty)	Recupera il valore della proprietà specificata su questo oggetto AutomationElement. Un valore predefinito appropriato per il tipo di proprietà viene restituito per le proprietà non supportato in modo esplicito dall'elemento dell'interfaccia utente di destinazione.
GetCurrentPropertyValue(AutomationProperty, Boolean)	Recupera il valore della proprietà specificata su questo oggetto AutomationElement, ignorando facoltativamente qualsiasi proprietà predefinita.

Commenti

Il valore restituito dal GetCurrentPropertyValue metodo è corrente al momento della chiamata. Il valore può cambiare successivamente da altre applicazioni che interagiscono con l'interfaccia utente.

Per alcune forme di interfaccia utente, questo metodo comporta un sovraccarico delle prestazioni tra processi. Le applicazioni possono concentrarsi sull'overhead memorizzando nella cache le proprietà e recuperandole usando GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty)

Recupera il valore della proprietà specificata su questo oggetto AutomationElement. Un valore predefinito appropriato per il tipo di proprietà viene restituito per le proprietà non supportato in modo esplicito dall'elemento dell'interfaccia utente di destinazione.

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

Identificatore della proprietà Automazione interfaccia utente che specifica la proprietà da recuperare.

Restituisce

Object

Oggetto contenente il valore della proprietà specificata.

Eccezioni

ElementNotAvailableException

L'interfaccia utente per AutomationElement non esiste più.

Esempio

Nell'esempio seguente viene recuperato il valore corrente della HelpText proprietà . Il valore predefinito viene restituito se l'elemento non ne fornisce uno.

// 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 è corrente al momento della chiamata. Il valore può successivamente cambiare da altre applicazioni che interagiscono con l'interfaccia utente.

Se il provider di Automazione interfaccia utente per l'elemento stesso supporta la proprietà , viene restituito il valore della proprietà . In caso contrario, viene restituita una proprietà predefinita specificata da Automazione interfaccia utente. Per informazioni sulle proprietà predefinite, vedere i campi dell'identificatore di proprietà di AutomationElement, ad esempio AcceleratorKeyProperty.

Per alcune forme di interfaccia utente, questo metodo comporta un sovraccarico delle prestazioni tra processi. Concentrare l'overhead memorizzando nella cache le proprietà e recuperandole usando GetCachedPropertyValue.

GetCurrentPropertyValue(AutomationProperty, Boolean)

Recupera il valore della proprietà specificata su questo oggetto AutomationElement, ignorando facoltativamente qualsiasi proprietà predefinita.

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

Identificatore della proprietà Automazione interfaccia utente che specifica la proprietà da recuperare.

ignoreDefaultValue

Boolean

Valore che specifica se un valore predefinito deve essere ignorato in caso di supporto della proprietà specificata.

Restituisce

Object

Oggetto contenente il valore della proprietà specificata o NotSupported se l'elemento non fornisce un valore e ignoreDefaultValue è true.

Eccezioni

ElementNotAvailableException

L'interfaccia utente per AutomationElement non esiste più.

Esempio

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 anziché un valore predefinito.

// 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

false ignoreDefaultValue Il passaggio di è equivalente alla chiamata AutomationElement.GetCurrentPropertyValue(AutomationProperty)a .

Se il provider di Automazione interfaccia utente per l'elemento stesso supporta la proprietà , viene restituito il valore della proprietà . In caso contrario, se ignoreDefaultValue è false, viene restituita una proprietà predefinita specificata da Automazione interfaccia utente. Per informazioni sulle proprietà predefinite, vedere i campi dell'identificatore di proprietà di AutomationElement, ad esempio AcceleratorKeyProperty.

Il valore restituito dal GetCurrentPropertyValue metodo è corrente al momento della chiamata. Il valore può cambiare successivamente da altre applicazioni che interagiscono con l'interfaccia utente.

Per alcune forme di interfaccia utente, questo metodo comporta un sovraccarico delle prestazioni tra processi. Le applicazioni possono concentrarsi sull'overhead memorizzando nella cache le proprietà e recuperandole usando GetCachedPropertyValue.