Condividi tramite

Pattern di controllo scroll

  • Articolo

Vengono descritte le linee guida e le convenzioni per l'implementazione di IScrollProvider, incluse informazioni sulle proprietà e sui metodi. Il pattern di controllo scroll viene usato per supportare un controllo che funge da contenitore scorrevole per una raccolta di oggetti figlio.

Il controllo non è necessario per usare le barre di scorrimento per supportare la funzionalità di scorrimento, anche se in genere. L'immagine seguente mostra un controllo di scorrimento che non usa le barre di scorrimento. Per esempi di controlli che implementano questo pattern di controllo, vedere Tipi di controllo e i relativi pattern di controllo supportati.

schermata che mostra un controllo di scorrimento senza barre di scorrimento

Questo argomento contiene le sezioni seguenti.

Linee guida e convenzioni di implementazione

Quando si implementa il pattern di controllo scroll, tenere presenti le linee guida e le convenzioni seguenti:

  • Gli elementi figlio di questo controllo devono implementare IScrollItemProvider.
  • Le barre di scorrimento di un controllo contenitore non supportano il pattern di controllo scroll. Devono invece supportare il pattern di controllo RangeValue.
  • Quando lo scorrimento viene misurato in percentuali, tutti i valori o gli importi correlati alla graduazione di scorrimento devono essere normalizzati in un intervallo compreso tra 0 e 100.
  • La proprietà IScrollProvider::HorizontallyScrollable e proprietà VerticallyScrollable sono indipendenti dalla proprietà IsEnabled.
  • Se la proprietà IScrollProvider::HorizontallyScrollable è FALSE, la proprietàHorizontalViewSizedeve essere impostata su 100 (100%) e proprietà HorizontalScrollPercent deve essere impostata su UIA_ScrollPatternNoScroll (-1). Analogamente, se la proprietà VerticallyScrollable è FALSE, la proprietà VerticalViewSize deve essere impostata su 100 (100%) e la proprietà VerticalScrollPercent deve essere impostata su UIA_ScrollPatternNoScroll (-1). Ciò consente a un client di Automazione interfaccia utente Microsoft di usare questi valori di proprietà all'interno del metodo SetScrollPercent evitando una race condition se una direzione del client non è interessata allo scorrimento diventa attivata.
  • La proprietà IScrollProvider::HorizontalScrollPercent è specifica delle impostazioni locali. L'impostazione di HorizontalScrollPercent su 100 deve impostare la posizione di scorrimento del controllo sull'equivalente della posizione più a destra per le lingue come l'inglese letto da sinistra a destra. In alternativa, per le lingue come l'arabo che legge da destra a sinistra, impostare HorizontalScrollPercent su 100 deve impostare la posizione di scorrimento sulla posizione più a sinistra.

Membri obbligatori per IScrollProvider

Per implementare l'interfaccia IScrollProvider sono necessari i metodi e le proprietà seguenti.

Membri obbligatori Tipo di membro Note
HorizontalScrollPercent Proprietà Nessuno
VerticalScrollPercent Proprietà Nessuno
HorizontalViewSize Proprietà Nessuno
VerticalViewSize Proprietà Nessuno
HorizontallyScrollable Proprietà Nessuno
VerticallyScrollable Proprietà Nessuno
scroll Metodo Nessuno
SetScrollPercent Metodo Nessuno

 

Questo pattern di controllo non ha eventi associati.

tipi di controllo e i relativi modelli di controllo supportati

Panoramica modelli di controllo di automazione interfaccia utente

panoramica dell'albero di automazione interfaccia utente