Pattern di controllo TextChild

Introduce linee guida e convenzioni per l'implementazione di ITextChildProvider, incluse informazioni sulle proprietà e sui 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 utilizzano gli strumenti di Automazione interfaccia utente Microsoft per esaminare l'albero di Automazione interfaccia utente per il contenuto del documento, potrebbe essere visualizzato un elemento documento con un elemento figlio che rappresenta l'immagine e un altro elemento figlio che rappresenta il collegamento ipertestuale. Ad esempio:

In genere, l'elemento documento nell'esempio precedente supporta il pattern di controllo Text , ma i due elementi figlio dell'elemento del documento non lo supportano. 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 modello Textcontrol esposto dall'elemento del documento contenitore.

Linee guida e convenzioni di implementazione

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

• La proprietà ITextChildProvider::TextContainer deve specificare l'elemento predecessore più vicino che supporta l'interfaccia ITextProvider , indipendentemente dal fatto che gli elementi superiori nella catena predecessore supportino anche ITextProvider.
• Un elemento non deve supportare sia l'interfacciaITextProvider che l'interfaccia ITextChildProvider** .
• Un elemento che implementa ITextChildProvider deve essere 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 viene chiamata la relativa funzione ITextProvider::RangeFromChild con l'elemento figlio di testo come elemento figlio racchiuso.

Membri obbligatori per ITextChildProvider

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

Questo pattern di controllo non è associato a metodi o eventi.

Argomenti correlati

Informazioni concettuali

• Tipi di controllo e modelli di controllo supportati
• Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente
• Panoramica dell'albero di automazione dell'interfaccia utente