Condividi tramite

Metodo IUIAutomationTextRange::MoveEndpointByUnit (uiautomationclient.h)

  • Articolo

Sposta un endpoint dell'intervallo di testo del numero specificato di unità di testo nell'intervallo del documento.

Sintassi

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

Parametri

[in] endpoint

Tipo: TextPatternRangeEndpoint

Valore che specifica l'endpoint (inizio o fine) da spostare.

[in] unit

Tipo: TextUnit

Valore che specifica l'unità testuale per lo spostamento, ad esempio riga o paragrafo.

[in] count

Tipo: int

Numero di unità da spostare. Un numero positivo comporta lo spostamento in avanti dell'endpoint. Un numero negativo comporta lo spostamento indietro. Un numero pari a 0 non ha effetto.

[out, retval] moved

Tipo: int*

Riceve il conteggio delle unità effettivamente spostate. Questo valore può essere minore del numero richiesto se lo spostamento dell'endpoint viene eseguito all'inizio o alla fine del documento.

Valore restituito

Tipo: HRESULT

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

Commenti

L'endpoint viene spostato in avanti o indietro, come specificato, al limite successivo dell'unità disponibile. Se l'endpoint originale si trovava al limite dell'unità di testo specificata, l'endpoint viene spostato al limite successivo dell'unità di testo disponibile, come illustrato nella figura seguente.

Figura che mostra gli endpoint di un intervallo di testo in movimento Se l'endpoint spostato attraversa l'altro endpoint dello stesso intervallo di testo, viene spostato anche l'altro endpoint , generando un intervallo degenerato e assicurando l'ordinamento corretto dell'endpoint , ovvero che l'inizio è sempre minore o uguale alla fine.

MoveEndpointByUnit depreca fino all'unità di testo supportata successiva se l'unità di testo specificata non è supportata dal controllo.

L'ordine, dall'unità più piccola alla più grande, è elencato qui.

  • Carattere
  • Formato
  • Word
  • Linea
  • Paragraph
  • Page
  • Documento

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

TextUnit::Format come valore unitario posiziona il limite di un intervallo di testo per espandere o spostare l'intervallo in base agli attributi di testo condiviso (formato) del testo all'interno dell'intervallo. Tuttavia, l'uso dell'unità di testo di formato non sposta o espande un intervallo di testo oltre il limite di un oggetto incorporato, ad esempio un'immagine o un collegamento ipertestuale. Per altre info, vedi 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 (include UIAutomation.h)

Vedi anche

IUIAutomationTextRange

supporto di Automazione interfaccia utente per il contenuto testuale