Modèle de contrôle SpreadsheetItem

Décrit les instructions et les conventions pour l’implémentation d’ISpreadsheetItemProvider, y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle SpreadsheetItem est utilisé pour exposer les propriétés d’une cellule dans une feuille de calcul ou un autre document basé sur une grille.

Le modèle de contrôle SpreadsheetItem est étroitement lié au modèle de contrôle GridItem ; les contrôles qui implémentent le modèle de contrôle SpreadsheetItem doivent également implémenter le modèle de contrôle GridItem. Les contrôles peuvent également implémenter le modèle de contrôle TableItem , le cas échéant. Pour obtenir des exemples de contrôles qui implémentent ces modèles de contrôle, consultez Types de contrôles et leurs modèles de contrôle pris en charge.

Cette rubrique contient les sections suivantes.

• Conventions et directives d'implémentation
• Membres obligatoires pour ISpreadsheetItemProvider
• Rubriques connexes

Conventions et directives d'implémentation

Lors de l’implémentation du modèle de contrôle SpreadsheetItem , notez les directives et conventions suivantes :

• Lorsque vous implémentez les méthodes ISpreadsheetItemProvider::GetAnnotationObjects et ISpreadsheetItemProvider::GetAnnotationTypes , reportez-vous à la documentation IAnnotationProvider . Ces méthodes retournent des tableaux pour permettre aux fournisseurs de prendre en charge plusieurs annotations sur une seule cellule.
• Certains types d’annotations ne nécessitent pas d’implémentation complète de l’interface IAnnotationProvider . Par exemple, un indicateur d’erreur d’orthographe simple peut être représenté en faisant en sorte que GetAnnotationTypes retourne un identificateur d’attribut texte de AnnotationType_SpellingError et que GetAnnotationObjects retourne une valeur null.

Membres obligatoires pour ISpreadsheetItemProvider

Les propriétés et méthodes suivantes sont requises pour implémenter l’interface ISpreadsheetItemProvider .

Membres nécessaires	Type de membre	Notes
Formule	Propriété	L’implémentation d’une propriété Formula distincte est nécessaire, car la propriété Value d’une cellule retourne généralement la valeur calculée de la cellule. La propriété Formula doit avoir la valeur NULL si aucune formule n’est définie.
GetAnnotationObjects	Méthode	Retourne un tableau de fournisseurs d’éléments qui font référence aux annotations liées à cette cellule. Les pointeurs dans le tableau peuvent être null si une annotation n’a pas de fournisseur lié.
GetAnnotationTypes	Méthode	Retourne un tableau d’identificateurs de type d’annotation qui décrivent les annotations de cette cellule. Le tableau doit avoir la même taille que le tableau retourné par GetAnnotationObjects.

 

Ce modèle de contrôle n’est associé aucun événement.

Rubriques connexes

Conceptuel

Types de contrôles et leurs modèles de contrôle pris en charge

Modèle de contrôle de feuille de calcul

Vue d'ensemble des modèles de contrôle UI Automation

Vue d’ensemble de l’arborescence UI Automation