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