Шаблон элемента управления SpreadsheetItem
Описание рекомендаций и соглашений по реализации ISpreadsheetItemProvider, включая сведения о свойствах и методах. Шаблон элемента управления SpreadsheetItem используется для предоставления свойств ячейки в электронной таблице или другом документе на основе сетки.
Шаблон элемента управления SpreadsheetItem тесно связан с шаблоном элемента управления GridItem ; Элементы управления, реализующие шаблон элемента управления SpreadsheetItem , также должны реализовывать шаблон элемента управления GridItem. Элементы управления также могут реализовывать шаблон элемента управления TableItem , если это необходимо. Примеры элементов управления, реализующих эти шаблоны элементов управления, см. в разделах Типы элементов управления и Поддерживаемые ими шаблоны элементов управления.
В этом разделе содержатся следующие подразделы.
Правила и соглашения реализации
При реализации шаблона элемента управления SpreadsheetItem обратите внимание на следующие рекомендации и соглашения.
- При реализации методов ISpreadsheetItemProvider::GetAnnotationObjects и ISpreadsheetItemProvider::GetAnnotationTypes обратитесь к документации по IAnnotationProvider . Оба этих метода возвращают массивы, чтобы поставщики могли поддерживать несколько заметок в одной ячейке.
- Некоторые виды заметок не требуют полной реализации интерфейса IAnnotationProvider . Например, простой индикатор орфографической ошибки может быть представлен тем, что GetAnnotationTypes возвращает идентификатор текстового атрибута AnnotationType_SpellingError, а GetAnnotationObjects возвращает значение NULL.
Обязательные элементы для ISpreadsheetItemProvider
Для реализации интерфейса ISpreadsheetItemProvider требуются следующие свойства и методы.
| Обязательные члены | Тип члена | Примечания |
|---|---|---|
| Формула | Свойство | Реализация отдельного свойства Formula необходима, так как свойство Value ячейки обычно возвращает вычисляемое значение ячейки. Если формула не задана, свойство Formula должно иметь значение NULL . |
| GetAnnotationObjects | Метод | Возвращает массив поставщиков элементов, ссылающихся на заметки, связанные с этой ячейкой. Указатели в массиве могут иметь значение NULL, если у заметки нет связанного поставщика. |
| GetAnnotationTypes | Метод | Возвращает массив идентификаторов типов заметок, описывающих заметки в этой ячейке. Массив должен иметь тот же размер, что и массив, возвращаемый getAnnotationObjects. |
Этот шаблон элемента управления не имеет связанных событий.
Связанные темы
-
Основные понятия
-
Типы элементов управления и поддерживаемые ими шаблоны элементов управления
-
Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса
-
Общие сведения о дереве модели автоматизации пользовательского интерфейса