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 .
Membri obbligatori | Tipo di membro | Note |
---|---|---|
TextContainer | Proprietà | Nessuno |
Textrange | Proprietà | Nessuno |
Questo pattern di controllo non è associato a metodi o eventi.
Argomenti correlati
Informazioni concettuali