Worksheet Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет лист.
public interface class Worksheet : Microsoft::Office::Interop::Excel::_Worksheet, Microsoft::Office::Interop::Excel::DocEvents_Event
[System.Runtime.InteropServices.Guid("000208D8-0000-0000-C000-000000000046")]
public interface Worksheet : Microsoft.Office.Interop.Excel._Worksheet, Microsoft.Office.Interop.Excel.DocEvents_Event
Public Interface Worksheet
Implements _Worksheet, DocEvents_Event
- Производный
- Атрибуты
- Реализации
Комментарии
Это интерфейс .NET, полученный из компонентного класса COM, который требуется управляемому программному коду для взаимодействия с соответствующим объектом COM. Используйте этот вторичный интерфейс для доступа ко всем методам, свойствам и членам событий объекта COM. Однако если метод или событие, которые требуется использовать, имеют одно и то же имя в каком-либо объекте COM, для вызова метода приведите к соответствующему основному интерфейсу, для соединения с событием приведите к интерфейсу последних событий. Для получения дополнительной информации об объекте COM обращайтесь к этому разделу. Сведения о методах и элементах свойств объекта COM см. в разделе _Worksheet.
Объект Worksheet является членом Worksheets коллекции. Коллекция Worksheets содержит все объекты Worksheet в книге.
В этом разделе описаны следующие свойства для возврата объекта Worksheet :
- Worksheets Свойство
- ActiveSheet Свойство
Свойство Worksheets
Используйте Worksheets(index), где index — номер или имя индекса листа, чтобы вернуть один объект Worksheet .
Номер индекса листа обозначает положение листа на панели вкладок книги. Worksheets(1) — это первый (самый левый) лист в книге, а лист(Worksheets.Count) — последний. Все листы включаются в число индексов, даже если они скрыты.
Имя листа отображается на вкладке листа. Используйте свойство , Name чтобы задать или вернуть имя листа.
Объект Worksheet также является членом Sheets коллекции. Коллекция Листов содержит все листы книги (как листы диаграмм, так и листы).
Свойство ActiveSheet
Если лист является активным листом, можно использовать свойство ActiveSheet для ссылки на него.
Свойства
| _CodeName |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| _DisplayRightToLeft |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Application |
При использовании без квалификатора объектов это свойство возвращает Application объект, представляющий приложение Microsoft Excel. Если используется с квалификатором объекта, это свойство возвращает объект Application, который представляет создателя указанного объекта (вы можете задать это свойство с объектом OLE-автоматизации для возврата приложения этого объекта). Только для чтения. (Унаследовано от _Worksheet) |
| AutoFilter |
Возвращает объект, AutoFilter если фильтрация включена. Возвращает значение Nothing , если фильтрация отключена. Только для чтения. (Унаследовано от _Worksheet) |
| AutoFilterMode |
Значение true , если на листе в настоящее время отображаются стрелки раскрывающегося списка Автофильтр. Это свойство не зависит от FilterMode свойства . Для чтения и записи, Boolean. (Унаследовано от _Worksheet) |
| Cells |
Range Возвращает объект , представляющий все ячейки на листе (а не только используемые в данный момент ячейки). Только для чтения. (Унаследовано от _Worksheet) |
| CircularReference |
Range Возвращает объект , представляющий диапазон, содержащий первую круговую ссылку на листе, или возвращает значение Nothing, если на листе нет круговой ссылки. Перед продолжением вычисления необходимо удалить циклическую ссылку. Только для чтения. (Унаследовано от _Worksheet) |
| CodeName |
Возвращает имя кода для объекта . Только для чтения, String. (Унаследовано от _Worksheet) |
| Columns |
Range Возвращает объект , представляющий все столбцы указанного листа. Только для чтения. (Унаследовано от _Worksheet) |
| Comments |
Возвращает коллекцию Comments , представляющую все комментарии для указанного листа. Только для чтения. (Унаследовано от _Worksheet) |
| ConsolidationFunction |
Возвращает код функции, используемый для текущей консолидации. Может быть одной из XlConsolidationFunction констант. Только для чтения. (Унаследовано от _Worksheet) |
| ConsolidationOptions |
Возвращает трехэлейный массив параметров консолидации, как показано в следующей таблице. Если элемент имеет значение True, этот параметр устанавливается. Объект только для чтения. (Унаследовано от _Worksheet) |
| ConsolidationSources |
Возвращает массив строковых значений, которые называют исходные листы для текущей консолидации листа. Возвращает значение Empty , если на листе нет консолидации. Объект только для чтения. (Унаследовано от _Worksheet) |
| Creator |
Возвращает константу в перечислении XlCreator , указывающую приложение, в котором был создан этот объект. Если объект был создан в Microsoft Excel, это свойство возвращает строку XCEL, эквивалентную шестнадцатеричной цифре 5843454C. XlCreatorCode, доступный только для чтения. (Унаследовано от _Worksheet) |
| CustomProperties |
Возвращает объект, CustomProperties представляющий сведения об идентификаторе, связанные с листом. (Унаследовано от _Worksheet) |
| DisplayAutomaticPageBreaks |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| DisplayPageBreaks |
Значение true , если на указанном листе отображаются разрывы страниц (как автоматические, так и вручную). Для чтения и записи, Boolean. (Унаследовано от _Worksheet) |
| DisplayRightToLeft |
Значение true , если указанное окно, лист или объект ListObject отображается справа налево, а не слева направо. False , если объект отображается слева направо. Только для чтения, Boolean. (Унаследовано от _Worksheet) |
| EnableAutoFilter |
Значение true, если стрелки автофильтра включены, если включена защита только для пользовательского интерфейса. Для чтения и записи, Boolean. (Унаследовано от _Worksheet) |
| EnableCalculation |
Значение true, если Microsoft Excel автоматически пересчитывает лист при необходимости. Значение false , если Excel не пересчитывает лист. Для чтения и записи, Boolean. (Унаследовано от _Worksheet) |
| EnableFormatConditionsCalculation |
Возвращает или задает значение , если условные форматы будут возникать автоматически по мере необходимости. Для чтения и записи, Boolean. (Унаследовано от _Worksheet) |
| EnableOutlining |
Значение true , если символы структурирования включены, если включена защита только для пользовательского интерфейса. Для чтения и записи, Boolean. (Унаследовано от _Worksheet) |
| EnablePivotTable |
Значение true, если элементы управления и действия сводной таблицы включены, если включена защита только для пользовательского интерфейса. Для чтения и записи, Boolean. (Унаследовано от _Worksheet) |
| EnableSelection |
Возвращает или задает то, что можно выбрать на листе. Чтение и запись XlEnableSelection. (Унаследовано от _Worksheet) |
| FilterMode |
Значение true , если лист находится в режиме фильтра. Только для чтения, Boolean. (Унаследовано от _Worksheet) |
| HPageBreaks |
Возвращает коллекцию HPageBreaks , представляющую горизонтальные разрывы страниц на листе. Только для чтения. (Унаследовано от _Worksheet) |
| Hyperlinks |
Возвращает коллекцию Hyperlinks , представляющую гиперссылки для диапазона или листа. (Унаследовано от _Worksheet) |
| Index |
Возвращает номер индекса объекта в коллекции аналогичных объектов. Только для чтения, Integer. (Унаследовано от _Worksheet) |
| ListObjects |
Возвращает коллекцию ListObject объектов на листе. Коллекция ListObjects только для чтения. (Унаследовано от _Worksheet) |
| MailEnvelope |
Представляет заголовок электронной почты для документа. (Унаследовано от _Worksheet) |
| Name |
Возвращает или задает имя объекта. Для чтения и записи, String. (Унаследовано от _Worksheet) |
| Names |
Возвращает коллекцию Names , представляющую все имена, относящиеся к листу (имена, определенные с префиксом "WorksheetName!"). Объект Имен , доступный только для чтения. (Унаследовано от _Worksheet) |
| Next |
ChartВозвращает объект , Rangeили Worksheet , представляющий следующий лист или ячейку. Только для чтения. (Унаследовано от _Worksheet) |
| OnCalculate |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| OnData |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| OnDoubleClick |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| OnEntry |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| OnSheetActivate |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| OnSheetDeactivate |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Outline |
Outline Возвращает объект , представляющий структуру указанного листа. Только для чтения. (Унаследовано от _Worksheet) |
| PageSetup |
PageSetup Возвращает объект , содержащий все параметры настройки страницы для указанного объекта. Только для чтения. (Унаследовано от _Worksheet) |
| Parent |
Возвращает родительский объект для указанного объекта. Только для чтения. (Унаследовано от _Worksheet) |
| Previous |
ChartВозвращает объект , Rangeили Worksheet , который представляет предыдущий лист или ячейку. Только для чтения. (Унаследовано от _Worksheet) |
| PrintedCommentPages |
Возвращает количество страниц комментариев, которые будут напечатаны для текущего листа. (Унаследовано от _Worksheet) |
| ProtectContents |
Значение true , если содержимое листа защищено. Для диаграммы это защищает всю диаграмму. Для листа это защищает отдельные ячейки. Только для чтения, Boolean. (Унаследовано от _Worksheet) |
| ProtectDrawingObjects |
Значение True , если фигуры защищены. Только для чтения, Boolean. (Унаследовано от _Worksheet) |
| Protection |
Protection Возвращает объект , представляющий параметры защиты листа. (Унаследовано от _Worksheet) |
| ProtectionMode |
Значение true , если включена защита только для пользовательского интерфейса. Чтобы включить защиту пользовательского Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) интерфейса, используйте метод с аргументом |
| ProtectScenarios |
Значение true , если сценарии на листе защищены. Только для чтения, Boolean. (Унаследовано от _Worksheet) |
| QueryTables |
Возвращает коллекцию QueryTables , представляющую все таблицы запросов на указанном листе. Только для чтения. (Унаследовано от _Worksheet) |
| Range[Object, Object] |
Range Возвращает объект , представляющий ячейку или диапазон ячеек. (Унаследовано от _Worksheet) |
| Rows |
Range Возвращает объект , представляющий все строки на указанном листе. Объект Range предназначен только для чтения. (Унаследовано от _Worksheet) |
| Scripts |
Возвращает коллекцию Scripts , которая содержит Script объекты, представляющие блоки скрипта или кода в указанном документе при сохранении в виде веб-страницы. (Унаследовано от _Worksheet) |
| ScrollArea |
Возвращает или задает диапазон, в котором прокрутка разрешена в виде ссылки на диапазон в стиле A1. Ячейки за пределами области прокрутки не могут быть выбраны. Для чтения и записи, String. (Унаследовано от _Worksheet) |
| Shapes |
Shapes Возвращает объект , представляющий все фигуры на листе или листе диаграммы. Только для чтения. (Унаследовано от _Worksheet) |
| SmartTags |
Возвращает объект, SmartTags представляющий идентификатор указанной ячейки. (Унаследовано от _Worksheet) |
| Sort |
Возвращает отсортированные значения на текущем листе. Только для чтения. (Унаследовано от _Worksheet) |
| StandardHeight |
Возвращает стандартную (по умолчанию) высоту всех строк листа в точках. Только для чтения, Double. (Унаследовано от _Worksheet) |
| StandardWidth |
Возвращает или задает стандартную (по умолчанию) ширину всех столбцов на листе. Для чтения и записи, Double. (Унаследовано от _Worksheet) |
| Tab |
Tab Возвращает объект для диаграммы или листа. (Унаследовано от _Worksheet) |
| TransitionExpEval |
Значение true, если Microsoft Excel использует правила оценки выражений Lotus 1-2-3 для листа. Для чтения и записи, Boolean. (Унаследовано от _Worksheet) |
| TransitionFormEntry |
Значение true, если Microsoft Excel использует правила ввода формул Lotus 1-2-3 для листа. Для чтения и записи, Boolean. (Унаследовано от _Worksheet) |
| Type |
Возвращает или задает тип листа. Только для XlSheetTypeчтения . (Унаследовано от _Worksheet) |
| UsedRange |
Range Возвращает объект , представляющий используемый диапазон на указанном листе. Только для чтения. (Унаследовано от _Worksheet) |
| Visible |
Определяет, является ли объект видимым. Чтение и запись XlSheetVisibility. (Унаследовано от _Worksheet) |
| VPageBreaks |
Возвращает коллекцию VPageBreaks , представляющую вертикальные разрывы страницы на листе. Только для чтения. (Унаследовано от _Worksheet) |
Методы
| _CheckSpelling(Object, Object, Object, Object, Object, Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| _Evaluate(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| _PasteSpecial(Object, Object, Object, Object, Object, Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| _PrintOut(Object, Object, Object, Object, Object, Object, Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| _Protect(Object, Object, Object, Object, Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| _SaveAs(String, Object, Object, Object, Object, Object, Object, Object, Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Arcs(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Buttons(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| ChartObjects(Object) |
Возвращает объект , представляющий либо одну внедренную диаграмму ChartObject (объект), либо коллекцию всех внедренных диаграмм ( ChartObjects объект) на листе. (Унаследовано от _Worksheet) |
| CheckBoxes(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| CheckSpelling(Object, Object, Object, Object) |
Проверяет орфографию объекта. Эта форма не имеет возвращаемого значения; В Microsoft Excel отображается диалоговое окно Орфография. (Унаследовано от _Worksheet) |
| CircleInvalid() |
Круги недопустимых записей на листе. (Унаследовано от _Worksheet) |
| ClearArrows() |
Очищает стрелки трассировки с листа. Стрелки трассировки добавляются с помощью функции аудита. (Унаследовано от _Worksheet) |
| ClearCircles() |
Очищает круги от недопустимых записей на листе. (Унаследовано от _Worksheet) |
| Copy(Object, Object) |
Копирует лист в другое место в книге. (Унаследовано от _Worksheet) |
| Delete() |
Удаляет объект . (Унаследовано от _Worksheet) |
| DrawingObjects(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Drawings(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| DropDowns(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Evaluate(Object) |
Преобразует имя Microsoft Excel в объект или значение. (Унаследовано от _Worksheet) |
| ExportAsFixedFormat(XlFixedFormatType, Object, Object, Object, Object, Object, Object, Object, Object) |
Экспортирует в файл указанного формата. (Унаследовано от _Worksheet) |
| GroupBoxes(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| GroupObjects(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Labels(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Lines(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| ListBoxes(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Move(Object, Object) |
Перемещение листа в другое место в книге (Унаследовано от _Worksheet) |
| OLEObjects(Object) |
Возвращает объект , представляющий либо один объект OLE (), OLEObjectлибо коллекцию всех объектов OLE ( OLEObjects коллекция) на диаграмме или листе. Только для чтения. (Унаследовано от _Worksheet) |
| OptionButtons(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Ovals(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Paste(Object, Object) |
Вставляет содержимое буфера обмена на лист. (Унаследовано от _Worksheet) |
| PasteSpecial(Object, Object, Object, Object, Object, Object, Object) |
Вставляет содержимое буфера обмена на лист в указанном формате. Используйте этот метод для вставки данных из других приложений или для вставки данных в определенном формате. (Унаследовано от _Worksheet) |
| Pictures(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| PivotTables(Object) |
Возвращает объект , представляющий либо один отчет сводной таблицы ( PivotTable объект), либо коллекцию всех отчетов сводной таблицы ( PivotTables объект) на листе. Только для чтения. (Унаследовано от _Worksheet) |
| PivotTableWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Создает PivotTable объект . Этот метод не отображает мастер сводной таблицы. Этот метод недоступен для источников данных OLE DB. Add(Object, Object, Object, Object) Используйте метод , чтобы добавить кэш сводной таблицы, а затем создать отчет сводной таблицы на основе кэша. Объект сводной таблицы. (Унаследовано от _Worksheet) |
| PrintOut(Object, Object, Object, Object, Object, Object, Object, Object) |
Выводит объект . (Унаследовано от _Worksheet) |
| PrintOutEx(Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| PrintPreview(Object) |
Показывает предварительный просмотр объекта, как он будет выглядеть при печати. (Унаследовано от _Worksheet) |
| Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Защищает лист, чтобы его нельзя было изменить. (Унаследовано от _Worksheet) |
| Rectangles(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| ResetAllPageBreaks() |
Сбрасывает все разрывы страниц на указанном листе. (Унаследовано от _Worksheet) |
| SaveAs(String, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Сохраняет изменения на диаграмме или листе в другом файле. (Унаследовано от _Worksheet) |
| Scenarios(Object) |
Возвращает объект , представляющий один сценарий ( Scenario объект) или коллекцию сценариев ( Scenarios объект) на листе. (Унаследовано от _Worksheet) |
| ScrollBars(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Select(Object) |
Выбирает объект . (Унаследовано от _Worksheet) |
| SetBackgroundPicture(String) |
Задает фоновый рисунок для листа или диаграммы. (Унаследовано от _Worksheet) |
| ShowAllData() |
Делает все строки отфильтрованного списка видимыми. Если используется автофильтр, этот метод изменяет стрелки на "Все". (Унаследовано от _Worksheet) |
| ShowDataForm() |
Отображает форму данных, связанную с листом. (Унаследовано от _Worksheet) |
| Spinners(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| TextBoxes(Object) |
Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet) |
| Unprotect(Object) |
Удаляет защиту листа или книги. Этот метод не действует, если лист или книга не защищены. (Унаследовано от _Worksheet) |
| XmlDataQuery(String, Object, Object) |
Range Возвращает объект , представляющий ячейки, сопоставленные с определенным XPath. Возвращает значение Nothing , если указанный XPath не сопоставлен с листом или если сопоставленный диапазон пуст. (Унаследовано от _Worksheet) |
| XmlMapQuery(String, Object, Object) |
Range Возвращает объект , представляющий ячейки, сопоставленные с определенным XPath. Возвращает значение Nothing , если указанный XPath не сопоставлен с листом. (Унаследовано от _Worksheet) |
События
| Activate |
Происходит при активации листа. (Унаследовано от DocEvents_Event) |
| BeforeDelete |
Событие BeforeDelete возникает перед удалением любого листа. (Унаследовано от DocEvents_Event) |
| BeforeDoubleClick |
Происходит при двойном щелчке листа перед действием двойного щелчка по умолчанию. (Унаследовано от DocEvents_Event) |
| BeforeRightClick |
Происходит при щелчке листа правой кнопкой мыши перед действием по умолчанию. (Унаследовано от DocEvents_Event) |
| Calculate |
Происходит после пересчета листа. (Унаследовано от DocEvents_Event) |
| Change |
Происходит при изменении ячеек на листе пользователем или внешней ссылкой. (Унаследовано от DocEvents_Event) |
| Deactivate |
Происходит при отключении листа. (Унаследовано от DocEvents_Event) |
| FollowHyperlink |
Происходит при щелчке любой гиперссылки на листе. Сведения о событиях на уровне приложения и книги см. в описании события SheetFollowHyperlink . (Унаследовано от DocEvents_Event) |
| LensGalleryRenderComplete |
Происходит, когда значки коллекции выносок (динамические и статические) завершили отрисовку. (Унаследовано от DocEvents_Event) |
| PivotTableAfterValueChange |
Происходит после изменения или пересчета ячейки или диапазона ячеек в сводной таблице (для ячеек, содержащих формулы). (Унаследовано от DocEvents_Event) |
| PivotTableBeforeAllocateChanges |
Происходит до применения изменений к сводной таблице. (Унаследовано от DocEvents_Event) |
| PivotTableBeforeCommitChanges |
Происходит до фиксации изменений в источнике данных OLAP для сводной таблицы. (Унаследовано от DocEvents_Event) |
| PivotTableBeforeDiscardChanges |
Происходит до отмены изменений в сводной таблице. (Унаследовано от DocEvents_Event) |
| PivotTableChangeSync |
Происходит после внесения изменений в сводную таблицу. (Унаследовано от DocEvents_Event) |
| PivotTableUpdate |
Происходит после обновления отчета сводной таблицы на листе. (Унаследовано от DocEvents_Event) |
| SelectionChange |
Происходит при изменении выделения на листе. (Унаследовано от DocEvents_Event) |
| TableUpdate |
Происходит после обновления таблицы запросов, подключенной к модели данных, на листе. (Унаследовано от DocEvents_Event) |