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

Conceitual

Tipos de controle e seus padrões de controle com suporte

Padrão de controle de planilha

Visão Geral de Padrões de Controle de Automação de Interface de Usuário

Visão geral da árvore de automação de interface do usuário