Padrão de controle SpreadsheetItem
Descreve diretrizes e convenções para implementar ISpreadsheetItemProvider, incluindo informações sobre propriedades e métodos. O padrão de controle SpreadsheetItem é usado para expor as propriedades de uma célula em uma planilha ou outro documento baseado em grade.
O padrão de controle SpreadsheetItem está intimamente relacionado ao padrão de controle GridItem ; controles que implementam o padrão de controle SpreadsheetItem também devem implementar o padrão de controle GridItem. Os controles também podem implementar o padrão de controle TableItem , se apropriado. Para obter exemplos de controles que implementam esses padrões de controle, consulte Tipos de controle e seus padrões de controle com suporte.
Este tópico inclui as seções a seguir.
- Diretrizes e convenções de implementação
- Membros necessários para ISpreadsheetItemProvider
- Tópicos relacionados
Diretrizes e convenções de implementação
Ao implementar o padrão de controle SpreadsheetItem , observe as seguintes diretrizes e convenções:
- Ao implementar os métodos ISpreadsheetItemProvider::GetAnnotationObjects e ISpreadsheetItemProvider::GetAnnotationTypes , consulte a documentação do IAnnotationProvider . Esses métodos retornam matrizes para permitir que os provedores deem suporte a várias anotações em uma única célula.
- Alguns tipos de anotações não exigem uma implementação completa da interface IAnnotationProvider . Por exemplo, um indicador simples de erro ortográfico pode ser representado fazendo com que GetAnnotationTypes retorne um identificador de atributo de texto de AnnotationType_SpellingError e que GetAnnotationObjects retorne um valor nulo.
Membros necessários para ISpreadsheetItemProvider
As propriedades e os métodos a seguir são necessários para implementar a interface ISpreadsheetItemProvider .
| Membros necessários | Tipo de membro | Observações |
|---|---|---|
| Fórmula | Propriedade | A implementação de uma propriedade Formula separada é necessária porque a propriedade Value de uma célula normalmente retorna o valor calculado da célula. A propriedade Formula deverá ser NULL se nenhuma fórmula estiver definida. |
| GetAnnotationObjects | Método | Retorna uma matriz de provedores de elementos que se referem às anotações vinculadas a essa célula. Os ponteiros dentro da matriz poderão ser nulos se uma anotação não tiver um provedor vinculado. |
| GetAnnotationTypes | Método | Retorna uma matriz de identificadores de tipo de anotação que descrevem as anotações nessa célula. A matriz deve ter o mesmo tamanho que a matriz retornada por GetAnnotationObjects. |
Esse padrão de controle não tem eventos associados.
Tópicos relacionados