Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 em 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 contém 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 IAnnotationProvider. Esses métodos retornam matrizes para permitir que os provedores ofereçam 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 de erro ortográfico simples pode ser representado por ter GetAnnotationTypes retornar um identificador de atributo de texto de AnnotationType_SpellingErrore ter GetAnnotationObjects retornar um valor nulo.
Membros necessários para ISpreadsheetItemProvider
As propriedades e os métodos a seguir são necessários para implementar a interfaceISpreadsheetItemProvider.
| Membros necessários | Tipo de membro | Anotações |
|---|---|---|
| de Fórmulas | Propriedade | Implementar uma propriedadede Fórmulaseparada é necessária porque a propriedade Value de uma célula normalmente retorna o valor computado 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