AutomationElement.GetCurrentPropertyValue Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar det aktuella värdet för den angivna egenskapen från en AutomationElement.
Överlagringar
| Name | Description |
|---|---|
| GetCurrentPropertyValue(AutomationProperty) |
Hämtar värdet för den angivna egenskapen för den här AutomationElement. Ett lämpligt standardvärde för egenskapstypen returneras för egenskaper som inte uttryckligen stöds av målgränssnittselementet (UI). |
| GetCurrentPropertyValue(AutomationProperty, Boolean) |
Hämtar värdet för den angivna egenskapen på den här AutomationElement, om du vill ignorera alla standardegenskaper. |
Kommentarer
Värdet som returneras av GetCurrentPropertyValue metoden är aktuellt när det anropas. Värdet kan sedan ändras av andra program som interagerar med användargränssnittet .
För vissa former av användargränssnitt medför den här metoden prestandaöverbelastningar mellan processer. Program kan koncentrera sig på omkostnader genom att cachelagra egenskaper och sedan hämta dem med hjälp GetCachedPropertyValueav .
GetCurrentPropertyValue(AutomationProperty)
Hämtar värdet för den angivna egenskapen för den här AutomationElement. Ett lämpligt standardvärde för egenskapstypen returneras för egenskaper som inte uttryckligen stöds av målgränssnittselementet (UI).
public:
System::Object ^ GetCurrentPropertyValue(System::Windows::Automation::AutomationProperty ^ property);public object GetCurrentPropertyValue(System.Windows.Automation.AutomationProperty property);member this.GetCurrentPropertyValue : System.Windows.Automation.AutomationProperty -> objPublic Function GetCurrentPropertyValue (property As AutomationProperty) As ObjectParametrar
- property
- AutomationProperty
Den UI Automation egenskapsidentifieraren som anger vilken egenskap som ska hämtas.
Returer
Ett objekt som innehåller värdet för den angivna egenskapen.
Undantag
Användargränssnittet AutomationElement för finns inte längre.
Exempel
I följande exempel hämtas det aktuella värdet för HelpText egenskapen. Standardvärdet returneras om elementet inte tillhandahåller något.
// 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))
Kommentarer
Värdet som returneras av GetCurrentPropertyValue metoden är aktuellt när det anropas. Värdet kan sedan ändras av andra program som interagerar med användargränssnittet.
Om UI Automation providern för själva elementet stöder egenskapen returneras värdet för egenskapen. Annars returneras en standardegenskap som anges av UI Automation. Information om standardegenskaper finns i egenskapsidentifierarfälten AutomationElementi , till exempel AcceleratorKeyProperty.
För vissa former av användargränssnitt medför den här metoden prestandaöverbelastningar mellan processer. Koncentrera omkostnaderna genom att cachelagra egenskaper och sedan hämta dem med hjälp GetCachedPropertyValueav .
Gäller för
GetCurrentPropertyValue(AutomationProperty, Boolean)
Hämtar värdet för den angivna egenskapen på den här AutomationElement, om du vill ignorera alla standardegenskaper.
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 -> objPublic Function GetCurrentPropertyValue (property As AutomationProperty, ignoreDefaultValue As Boolean) As ObjectParametrar
- property
- AutomationProperty
Den UI Automation egenskapsidentifieraren som anger vilken egenskap som ska hämtas.
- ignoreDefaultValue
- Boolean
Ett värde som anger om ett standardvärde ska ignoreras om den angivna egenskapen stöds.
Returer
Ett objekt som innehåller värdet för den angivna egenskapen, eller NotSupported om elementet inte anger ett värde och ignoreDefaultValue är true.
Undantag
Användargränssnittet AutomationElement för finns inte längre.
Exempel
I följande exempel hämtas det aktuella värdet för HelpText egenskapen, men anger att om själva elementet inte tillhandahåller något värde för egenskapen NotSupported , returneras i stället för ett standardvärde.
// 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)
Kommentarer
Att skicka false in ignoreDefaultValue motsvarar anropet AutomationElement.GetCurrentPropertyValue(AutomationProperty).
Om UI Automation providern för själva elementet stöder egenskapen returneras värdet för egenskapen. Annars returneras en standardegenskap som anges av UI Automation om ignoreDefaultValue är false. Information om standardegenskaper finns i egenskapsidentifierarfälten AutomationElementi , till exempel AcceleratorKeyProperty.
Värdet som returneras av GetCurrentPropertyValue metoden är aktuellt när det anropas. Värdet kan sedan ändras av andra program som interagerar med användargränssnittet .
För vissa former av användargränssnitt medför den här metoden prestandaöverbelastningar mellan processer. Program kan koncentrera sig på omkostnader genom att cachelagra egenskaper och sedan hämta dem med hjälp GetCachedPropertyValueav .
