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

Devoluções

Um objeto contendo o valor da propriedade especificada.

Exceções

Exemplos

O exemplo seguinte recupera o valor atual da HelpText propriedade. O valor padrão é devolvido se o elemento não fornecer um.

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

Observações

O valor devolvido pelo GetCurrentPropertyValue método é atual no momento em que é chamado. O valor pode posteriormente mudar devido à interação de outras aplicações com a interface.

Se o fornecedor de Automatização da Interface de Utilizador para o próprio elemento suportar a propriedade, o valor da propriedade é devolvido. Caso contrário, uma propriedade padrão especificada pela Automatização da Interface de Utilizador é devolvida. Para informações sobre propriedades por defeito, consulte os campos identificadores de propriedade de AutomationElement, como AcceleratorKeyProperty.

Para algumas formas de UI, este método irá gerar sobrecarga de desempenho entre processos. Concentre a sobrecarga armazenando propriedades em cache e depois recuperando-as 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

Parâmetros

Devoluções

Um objeto contendo o valor da propriedade especificada, ou NotSupported se o elemento não fornecer um valor e ignoreDefaultValue é true.

Exceções

Exemplos

O exemplo seguinte recupera o valor atual da HelpText propriedade, mas especifica que, se o próprio elemento não fornecer um valor para a propriedade, NotSupported deve ser devolvido em vez de um valor padrão.

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

Observações

Passar false em ignoreDefaultValue é equivalente a chamar AutomationElement.GetCurrentPropertyValue(AutomationProperty).

Se o fornecedor de Automatização da Interface de Utilizador para o próprio elemento suportar a propriedade, o valor da propriedade é devolvido. Caso contrário, se ignoreDefaultValue for false, é devolvida uma propriedade padrão especificada por Automatização da Interface de Utilizador. Para informações sobre propriedades por defeito, consulte os campos identificadores de propriedade de AutomationElement, como AcceleratorKeyProperty.

O valor devolvido pelo GetCurrentPropertyValue método é atual no momento em que é chamado. O valor pode posteriormente mudar devido à interação de outras aplicações com a interface de utilizador (UI).

Para algumas formas de UI, este método irá gerar sobrecarga de desempenho entre processos. As aplicações podem concentrar sobrecarga ao armazenar propriedades em cache e depois recuperá-las usando GetCachedPropertyValue.