Patrón de control SpreadsheetItem

Describe instrucciones y convenciones para implementar ISpreadsheetItemProvider, incluida información sobre las propiedades y los métodos. El patrón de control SpreadsheetItem se usa para exponer las propiedades de una celda de una hoja de cálculo u otro documento basado en cuadrícula.

El patrón de control SpreadsheetItem está estrechamente relacionado con el patrón de control GridItem ; Los controles que implementan el patrón de control SpreadsheetItem también deben implementar el patrón de control GridItem. Los controles también pueden implementar el patrón de control TableItem , si procede. Para obtener ejemplos de controles que implementan estos patrones de control, vea Tipos de control y Sus patrones de control admitidos.

En este tema se incluyen las siguientes secciones.

• Directrices y convenciones de implementación
• Miembros necesarios para ISpreadsheetItemProvider
• Temas relacionados

Directrices y convenciones de implementación

Al implementar el patrón de control SpreadsheetItem , tenga en cuenta las siguientes directrices y convenciones:

• Al implementar los métodos ISpreadsheetItemProvider::GetAnnotationObjects e ISpreadsheetItemProvider::GetAnnotationTypes , consulte la documentación de IAnnotationProvider . Estos métodos devuelven matrices para permitir que los proveedores admitan varias anotaciones en una sola celda.
• Algunos tipos de anotaciones no requieren una implementación completa de la interfaz IAnnotationProvider . Por ejemplo, un indicador simple de error ortográfico podría representarse haciendo que GetAnnotationTypes devuelva un identificador de atributo de texto de AnnotationType_SpellingError y que GetAnnotationObjects devuelva un valor NULL.

Miembros necesarios para ISpreadsheetItemProvider

Se requieren las siguientes propiedades y métodos para implementar la interfaz ISpreadsheetItemProvider .

Miembros requeridos	Tipo de miembro	Notas
Fórmula	Propiedad	La implementación de una propiedad Formula independiente es necesaria porque la propiedad Value de una celda normalmente devuelve el valor calculado de la celda. La propiedad Formula debe ser NULL si no se establece ninguna fórmula.
GetAnnotationObjects	Método	Devuelve una matriz de proveedores de elementos que hacen referencia a las anotaciones vinculadas a esta celda. Los punteros dentro de la matriz pueden ser NULL si una anotación no tiene un proveedor vinculado.
GetAnnotationTypes	Método	Devuelve una matriz de identificadores de tipo de anotación que describen las anotaciones de esta celda. La matriz debe tener el mismo tamaño que la matriz devuelta por GetAnnotationObjects.

 

Este patrón de control no tiene eventos asociados.

Temas relacionados

Conceptual

Tipos de control y sus patrones de control admitidos

Patrón de control de hoja de cálculo

Información general acerca de los patrones de control de UI Automation

Información general sobre el árbol de la UI Automation