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) |