Condividi tramite

Metodo IUIAutomationTextRange::Move (uiautomationclient.h)

  • Articolo

Sposta l'intervallo di testo avanti o indietro per il numero specificato di unità di testo.

Sintassi

HRESULT Move(
  [in]          TextUnit unit,
  [in]          int      count,
  [out, retval] int      *moved
);

Parametri

[in] unit

Tipo: TextUnit

Valore che specifica il tipo di unità di testo, ad esempio carattere, parola, paragrafo e così via.

[in] count

Tipo: int

Numero di unità di testo da spostare. Un valore positivo sposta l'intervallo di testo in avanti. Un valore negativo sposta l'intervallo di testo indietro. Zero non ha alcun effetto.

[out, retval] moved

Tipo: int*

Riceve il numero di unità di testo effettivamente spostate. Ciò può essere minore del numero richiesto se uno dei nuovi endpoint dell'intervallo di testo è maggiore o minore degli endpoint recuperati dal metodo IUIAutomationTextPattern::D ocumentRange . Questo valore può essere negativo se lo spostamento si verifica nella direzione indietro.

Valore restituito

Tipo: HRESULT

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

Commenti

IUIAutomationTextRange::Move sposta l'intervallo di testo per estendersi in una parte diversa del testo; non modifica il testo in alcun modo.

Per un intervallo di testo non degenerato (non vuoto), IUIAutomationTextRange::Move normalizza e sposta l'intervallo eseguendo la procedura seguente.

  1. L'intervallo di testo viene compresso in un intervallo degenerato (vuoto) all'endpoint iniziale.
  2. Se necessario, l'intervallo di testo risultante viene spostato indietro nel documento all'inizio del limite dell'unità di testo richiesta.
  3. L'intervallo di testo viene spostato avanti o indietro nel documento dal numero richiesto di limiti di unità di testo.
  4. L'intervallo di testo viene espanso dallo stato degenerato spostando l'endpoint finale avanti da un limite di unità di testo richiesto.
Se uno dei passaggi precedenti ha esito negativo, l'intervallo di testo viene lasciato invariato. Se l'intervallo di testo non può essere spostato per quanto riguarda il numero richiesto di unità di testo, ma può essere spostato da un numero minore di unità di testo, l'intervallo di testo viene spostato dal numero minore di unità di testo e spostato viene impostato sul numero di unità di testo spostate.

Per un intervallo di testo degenerato, IUIAutomationTextRange::Move sposta semplicemente il punto di inserimento del testo in base al numero specificato di unità di testo.

Quando si sposta un intervallo di testo, IUIAutomationTextRange::Move ignora i limiti di tutti gli oggetti incorporati nel testo.

IUIAutomationTextRange::Move rispetta sia il testo nascosto che visibile.

Se un controllo basato su testo non supporta l'unità di testo specificata dal parametro unità , IUIAutomationTextRange::Move sostituisce la successiva unità di testo supportata più grande.

Le dimensioni delle unità di testo, dalla più piccola unità alla più grande, sono le seguenti.

  • Carattere
  • Formato
  • Word
  • Grafico a linee
  • Paragraph
  • Pagina
  • Documento

Comportamento dell'intervallo quando l'unità è TextUnit::Format

TextUnit::Format come valore unità posiziona il limite di un intervallo di testo per espandere o spostare l'intervallo in base agli attributi di testo condivisi (formato) del testo all'interno dell'intervallo. Tuttavia, l'uso dell'unità di testo di formato non verrà spostato o espanso un intervallo di testo oltre il limite di un oggetto incorporato, ad esempio un'immagine o un collegamento ipertestuale. Per altre informazioni, vedere Automazione interfaccia utente unità di testo o Automazione interfaccia utente supporto per il contenuto testuale.

Requisiti

Requisito Valore
Client minimo supportato Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione uiautomationclient.h (includere UIAutomation.h)

Vedi anche

IUIAutomationTextRange

Automazione interfaccia utente supporto per il contenuto testuale