Шаблон элемента управления SpreadsheetItem

Описание рекомендаций и соглашений по реализации ISpreadsheetItemProvider, включая сведения о свойствах и методах. Шаблон элемента управления SpreadsheetItem используется для предоставления свойств ячейки в электронной таблице или другом документе на основе сетки.

Шаблон элемента управления SpreadsheetItem тесно связан с шаблоном элемента управления GridItem ; Элементы управления, реализующие шаблон элемента управления SpreadsheetItem , также должны реализовывать шаблон элемента управления GridItem. Элементы управления также могут реализовывать шаблон элемента управления TableItem , если это необходимо. Примеры элементов управления, реализующих эти шаблоны элементов управления, см. в разделах Типы элементов управления и Поддерживаемые ими шаблоны элементов управления.

В этом разделе содержатся следующие подразделы.

• Правила и соглашения реализации
• Обязательные элементы для ISpreadsheetItemProvider
• Связанные темы

Правила и соглашения реализации

При реализации шаблона элемента управления SpreadsheetItem обратите внимание на следующие рекомендации и соглашения.

• При реализации методов ISpreadsheetItemProvider::GetAnnotationObjects и ISpreadsheetItemProvider::GetAnnotationTypes обратитесь к документации по IAnnotationProvider . Оба этих метода возвращают массивы, чтобы поставщики могли поддерживать несколько заметок в одной ячейке.
• Некоторые виды заметок не требуют полной реализации интерфейса IAnnotationProvider . Например, простой индикатор орфографической ошибки может быть представлен тем, что GetAnnotationTypes возвращает идентификатор текстового атрибута AnnotationType_SpellingError, а GetAnnotationObjects возвращает значение NULL.

Обязательные элементы для ISpreadsheetItemProvider

Для реализации интерфейса ISpreadsheetItemProvider требуются следующие свойства и методы.

Обязательные члены	Тип члена	Примечания
Формула	Свойство	Реализация отдельного свойства Formula необходима, так как свойство Value ячейки обычно возвращает вычисляемое значение ячейки. Если формула не задана, свойство Formula должно иметь значение NULL .
GetAnnotationObjects	Метод	Возвращает массив поставщиков элементов, ссылающихся на заметки, связанные с этой ячейкой. Указатели в массиве могут иметь значение NULL, если у заметки нет связанного поставщика.
GetAnnotationTypes	Метод	Возвращает массив идентификаторов типов заметок, описывающих заметки в этой ячейке. Массив должен иметь тот же размер, что и массив, возвращаемый getAnnotationObjects.

 

Этот шаблон элемента управления не имеет связанных событий.

Связанные темы

Основные понятия

Типы элементов управления и поддерживаемые ими шаблоны элементов управления

Шаблон элемента управления "Электронная таблица"

Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса

Общие сведения о дереве модели автоматизации пользовательского интерфейса