AutomationElement.GetCurrentPropertyValue Método

Definición

Espacio de nombres:

System.Windows.Automation

Ensamblado:

UIAutomationClient.dll

Recupera el valor actual de la propiedad especificada desde un objeto AutomationElement.

Sobrecargas

GetCurrentPropertyValue(AutomationProperty)	Recupera el valor de la propiedad especificada en el objeto AutomationElement. Se devuelve un valor predeterminado adecuado para el tipo de propiedad para las propiedades no admitidas explícitamente por el elemento de interfaz de usuario (UI) de destino.
GetCurrentPropertyValue(AutomationProperty, Boolean)	Recupera el valor de la propiedad especificada en AutomationElement; opcionalmente, se puede omitir cualquier propiedad predeterminada.

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 (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.

GetCurrentPropertyValue(AutomationProperty)

Recupera el valor de la propiedad especificada en el objeto AutomationElement. Se devuelve un valor predeterminado adecuado para el tipo de propiedad para las propiedades no admitidas explícitamente por el elemento de interfaz de usuario (UI) de destino.

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

property

AutomationProperty

Identificador de propiedad de automatización de la interfaz de usuario que especifica la propiedad que se va a recuperar.

Devoluciones

Object

Objeto que contiene el valor de la propiedad especificada.

Excepciones

ElementNotAvailableException

La interfaz de usuario para el AutomationElement ya no existe.

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.

GetCurrentPropertyValue(AutomationProperty, Boolean)

Recupera el valor de la propiedad especificada en AutomationElement; opcionalmente, se puede omitir cualquier propiedad predeterminada.

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

property

AutomationProperty

Identificador de propiedad de automatización de la interfaz de usuario que especifica la propiedad que se va a recuperar.

ignoreDefaultValue

Boolean

Valor que especifica si se debería omitir un valor predeterminado cuando no se admita la propiedad especificada.

Devoluciones

Object

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

Excepciones

ElementNotAvailableException

La interfaz de usuario para el AutomationElement ya no existe.

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.