Metodo ITextRangeProvider::FindAttribute (uiautomationcore.h)

Articolo
03/03/2024

Restituisce un subset di intervallo di testo con il valore dell'attributo di testo specificato.

Sintassi

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID    attributeId,
  [in]          VARIANT            val,
  [in]          BOOL               backward,
  [out, retval] ITextRangeProvider **pRetVal
);

Parametri

[in] attributeId

Tipo: TEXTATTRIBUTEID

Identificatore dell'attributo di testo. Per un elenco di ID attributo di testo, vedere Identificatori di attributo di testo.

[in] val

Tipo: VARIANT

Valore dell'attributo da cercare. Questo valore deve corrispondere al tipo specificato per l'attributo.

[in] backward

Tipo: BOOL

TRUE se l'ultimo intervallo di testo in corso deve essere restituito anziché il primo; in caso contrario FALSE.

[out, retval] pRetVal

Tipo: ITextRangeProvider**

Riceve un puntatore all'intervallo di testo con un attributo e un valore di attributo corrispondenti; in caso contrario , NULL.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il metodo FindAttribute recupera il testo corrispondente indipendentemente dal fatto che il testo sia nascosto o visibile. I client possono usare UIA_IsHiddenAttributeId per controllare la visibilità del testo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcore.h (include UIAutomation.h)

Vedi anche

Informazioni concettuali

ITextProvider

ITextRangeProvider

Riferimento

Cenni preliminari sui provider di automazione interfaccia utente

Condividi tramite