AutomationElement.GetCurrentPropertyValue Método

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

Parámetros

Devoluciones

Objeto que contiene el valor de la propiedad especificada.

Excepciones

Ejemplos

En el ejemplo siguiente se recupera el valor actual de la HelpText propiedad . El valor predeterminado se devuelve si el elemento no proporciona 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))

Comentarios

El valor devuelto por el GetCurrentPropertyValue método es actual en el momento en que se llama a . El valor puede cambiar posteriormente mediante otras aplicaciones que interactúan con la interfaz de usuario.

Si el proveedor de automatización de la interfaz de usuario del propio elemento admite la propiedad , se devuelve el valor de la propiedad . De lo contrario, se devuelve una propiedad predeterminada especificada por la automatización de la interfaz de usuario. Para obtener información sobre las propiedades predeterminadas, vea los campos de identificador de propiedad de AutomationElement, como AcceleratorKeyProperty.

Para algunas formas de interfaz de usuario, este método incurrirá en sobrecarga de rendimiento entre procesos. Concentrar la sobrecarga mediante el almacenamiento en caché de propiedades y, a continuación, recuperarlas mediante 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

Parámetros

Devoluciones

Objeto que contiene el valor de la propiedad especificada o NotSupported si el elemento no proporciona un valor e ignoreDefaultValue es true.

Excepciones

Ejemplos

En el ejemplo siguiente se recupera el valor actual de la HelpText propiedad , pero se especifica que si el propio elemento no proporciona un valor para la propiedad , NotSupported se devolverá en lugar de un valor predeterminado.

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

Comentarios

Pasar falseignoreDefaultValue es equivalente a llamar a AutomationElement.GetCurrentPropertyValue(AutomationProperty).

Si el proveedor de automatización de la interfaz de usuario del propio elemento admite la propiedad , se devuelve el valor de la propiedad . De lo contrario, si ignoreDefaultValue es false, se devuelve una propiedad predeterminada especificada por ui Automation. Para obtener información sobre las propiedades predeterminadas, vea los campos de identificador de propiedad de AutomationElement, como AcceleratorKeyProperty.

El valor devuelto por el GetCurrentPropertyValue método es actual en el momento en que se llama a . El valor puede cambiar posteriormente mediante otras aplicaciones que interactúan con la interfaz de usuario (UI).

Para algunas formas de interfaz de usuario, este método incurrirá en sobrecarga de rendimiento entre procesos. Las aplicaciones pueden concentrar la sobrecarga mediante el almacenamiento en caché de propiedades y, a continuación, recuperarlas mediante GetCachedPropertyValue.