Pattern di controllo TextChild

Introduce linee guida e convenzioni per l'implementazione di ITextChildProvider, incluse informazioni su proprietà e metodi. Il pattern di controllo TextChild viene usato per accedere al predecessore più vicino di un elemento che supporta il pattern di controllo Text.

Si supponga, ad esempio, che il testo in un documento contenga un'immagine incorporata e un collegamento ipertestuale, come illustrato nell'immagine seguente.

Se si usano gli strumenti di automazione interfaccia utente Microsoft per esaminare l'albero di automazione interfaccia utente per il contenuto di questo documento, potrebbe mostrare un elemento documento con un elemento figlio che rappresenta l'immagine e un altro elemento figlio che rappresenta il collegamento ipertestuale. Per esempio:

In genere, l'elemento documento nell'esempio precedente supporta il pattern di controllo Text, ma i due elementi figlio dell'elemento documento non lo fanno. Se un'applicazione client di automazione interfaccia utente ha un riferimento all'elemento image o all'elemento collegamento ipertestuale, il client può usare il pattern di controllo TextChild come modo pratico per accedere al pattern Textcontrol esposto dall'elemento documento contenitore.

Linee guida e convenzioni di implementazione

Quando si implementa l'interfacciaITextChildProvider, tenere presenti le linee guida e le convenzioni seguenti:

• La proprietà ITextChildProvider::TextContainer deve specificare l'elemento predecessore più vicino che supporta 'interfaccia di ITextProvider, indipendentemente dal fatto che gli elementi superiori nella catena predecessore supportino anche ITextProvider.
• Un elemento non deve supportare sia l'interfaccia IText Provider che quella ITextChildProvider**.
• Un elemento che implementa ITextChildProvider deve essere un elemento figlio o discendente di un elemento che implementa ITextProvider. Non è necessario che questo elemento implementi anche il pattern di controllo text .
• La proprietà ITextChildProvider::TextRange deve specificare lo stesso intervallo di testo restituito dall'elemento provider di testo contenitore quando la funzione ITextProvider::RangeFromChild viene chiamata con l'elemento figlio di testo come elemento figlio racchiuso.

Membri obbligatori per ITextChildProvider

Queste proprietà e metodi sono necessari per implementare l'interfacciaITextChildProvider.

Questo pattern di controllo non ha metodi o eventi associati.

Argomenti correlati

concettuale

• 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