AutomationElement.GetCurrentPropertyValue Metodo

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

Restituisce

Oggetto contenente il valore della proprietà specificata.

Eccezioni

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.

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

Restituisce

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

Eccezioni

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.