ActionsPane - интерфейс

Представляет настраиваемый пользовательский интерфейс для области задач Действия с документами в настройке уровня документа для Word или Excel.

Пространство имен:  Microsoft.Office.Tools
Сборка:  Microsoft.Office.Tools.Common (в Microsoft.Office.Tools.Common.dll)

Синтаксис

'Декларация
<GuidAttribute("b835a67a-c3c0-45ba-9a3f-c878bf531dd5")> _
Public Interface ActionsPane _
    Inherits IDisposable
[GuidAttribute("b835a67a-c3c0-45ba-9a3f-c878bf531dd5")]
public interface ActionsPane : IDisposable

Тип ActionsPane предоставляет следующие члены.

Свойства

  Имя Описание
Открытое свойство AccessibilityObject Получает объект AccessibleObject, назначенный области действий.
Открытое свойство AccessibleDefaultActionDescription Получает или задает описание действия по умолчанию в области действий.Это описание используется клиентскими приложениями со специальными возможностями.
Открытое свойство AccessibleDescription Получает или задает доступное описание области действий.Это описание используется клиентскими приложениями со специальными возможностями.
Открытое свойство AccessibleName Получает или задает доступное имя области действий.Это имя используется клиентскими приложениями со специальными возможностями.
Открытое свойство AccessibleRole Получает или задает доступную роль области действий.
Открытое свойство ActiveControl Получает или задает активный элемент управления в области действий.
Открытое свойство AllowDrop Получает или задает значение, указывающее, может ли область действий принимать данные, перетаскиваемые в нее пользователем.
Открытое свойство Anchor Получает или задает границы контейнера, с которым связана панель действий, и определяет способ изменения размеров пользовательского элемента управления при изменении размеров его родительского элемента.
Открытое свойство AutoRecover Возвращает или задает значение, указывающее, выполняется ли повторное автоматическое присоединение панели действий после ее отсоединения.
Открытое свойство AutoScaleDimensions Получает или задает размеры, заданные для панели действий при разработке.
Открытое свойство AutoScaleMode Получает или задает режим автоматического масштабирования области действий.
Открытое свойство AutoScroll Получает или задает значение, указывающее, позволяет ли панель действий пользователю выполнять прокрутку до любых элементов управления, расположенных вне ее видимых границ.
Открытое свойство AutoScrollMargin Получает или задает размер поля автоматической прокрутки области действий.
Открытое свойство AutoScrollMinSize Получает или задает минимальный размер автоматической прокрутки области действий.
Открытое свойство AutoScrollOffset Получает или задает расположение, в которое прокручивается область действий при вызове метода ScrollControlIntoView.
Открытое свойство AutoScrollPosition Получает или задает расположение позиции автоматической прокрутки области действий.
Открытое свойство AutoSize Инфраструктура. Это свойство не поддерживается панелью действий.
Открытое свойство AutoSizeMode Получает или задает режим, с помощью которого элемент управления области действий может автоматически изменять свои размеры.
Открытое свойство AutoValidate Получает или задает значение, указывающее, будут ли элементы управления в панели действий автоматически проверяться при изменении фокуса.
Открытое свойство BackColor Получает или задает цвет фона области действий.
Открытое свойство BackgroundImage Получает или задает фоновое изображение, отображаемое в области действий.
Открытое свойство BackgroundImageLayout Получает или задает позицию и поведение фонового изображения в области действий.
Открытое свойство BindingContext Получает или задает объект, который используется для синхронизации всех элементов управления в области действий, которые привязаны к одному источнику данных.
Открытое свойство BorderStyle Получает или задает стиль границы области действий.
Открытое свойство Bottom Получает расстояние (в пикселях) между нижней границей панели действий и верхней границей клиентской области ее контейнера.
Открытое свойство Bounds Получает или задает размер и местоположение (в пикселях) элемента управления панели действий, включая его неклиентские элементы, относительно его родительского элемента.
Открытое свойство CanFocus Получает значение, указывающее, может ли панель действий получать фокус.
Открытое свойство CanSelect Получает значение, указывающее, можно ли выбрать область действий.
Открытое свойство Capture Получает или задает значение, указывающее, была ли мышь захвачена областью действий.
Открытое свойство CausesValidation Получает или задает значение, указывающее, вызывает ли панель действий выполнение проверки для любых элементов управления, для которых требуется проверка, когда эта панель действий получает фокус.
Открытое свойство ClientRectangle Получает прямоугольник, представляющий клиентскую область панели действий.
Открытое свойство ClientSize Получает или задает высоту и ширину клиентской области панели действий.
Открытое свойство CompanyName Получает название компании или имя создателя приложения, содержащего панель действий.
Открытое свойство Container Инфраструктура. Это свойство не поддерживается панелью действий.
Открытое свойство ContainsFocus Получает значение, указывающее, имеет ли в данный момент панель действий или один из ее дочерних элементов управления фокус ввода.
Открытое свойство ContextMenu Получает или задает контекстное меню, связанное с областью действий.
Открытое свойство ContextMenuStrip Получает или задает объект ContextMenuStrip, связанный с областью действий.
Открытое свойство Controls Получает коллекцию элементов управления, содержащихся в области действий.
Открытое свойство Created Получает значение, указывающее, была ли создана область действий.
Открытое свойство CurrentAutoScaleDimensions Получает текущие измерения экрана во время выполнения.
Открытое свойство Cursor Получает или задает курсор, отображаемый, когда указатель мыши удерживается над панелью действий.
Открытое свойство DataBindings Получает привязки данных для области действий.
Открытое свойство DisplayRectangle Получает прямоугольник, представляющий отображаемую область панели действий.
Открытое свойство Disposing Получает значение, указывающее, находится ли область действий в процессе удаления.
Открытое свойство Dock Получает или задает границы элемента управления области действий, прикрепленные к его родительскому элементу, и определяет способ изменения размеров элемента управления области действий с его родительским элементом.
Открытое свойство DockPadding Инфраструктура. Это свойство не поддерживается панелью действий.
Открытое свойство Enabled Получает или задает значение, указывающее, может ли область действий отвечать на действия пользователя.
Открытое свойство Focused Получает значение, указывающее, имеется ли в области действий фокус ввода.
Открытое свойство Font Получает или задает шрифт текста, отображаемого в панели действий.
Открытое свойство ForeColor Получает или задает цвет переднего плана области действий.
Открытое свойство Handle Получает дескриптор окна, с которым связан элемент управления области действий.
Открытое свойство HasChildren Получает значение, указывающее, содержит ли элемент управления один или несколько дочерних элементов управления.
Открытое свойство Height Получает или задает высоту элемента управления области действий.
Открытое свойство HorizontalScroll Получает характеристики, связанные с горизонтальной полосой прокрутки.
Открытое свойство ImeMode Получает или задает режим редактора метода ввода панели действий.
Открытое свойство InvokeRequired Получает значение, указывающее, должен ли вызывающий объект вызывать метод invoke при обращении метода к элементу управления панели действий, так как вызывающий объект находится не в том потоке, в котором был создан элемент управления панели действий.
Открытое свойство IsAccessible Получает или задает значение, указывающее, является ли область действий видимой для приложений со специальными возможностями.
Открытое свойство IsDisposed Получает значение, указывающее, был ли удален элемент управления области действий.
Открытое свойство IsHandleCreated Получает значение, указывающее, имеется ли у элемента управления области действий связанный с ним дескриптор.
Открытое свойство IsMirrored Получает значение, указывающее на наличие зеркального отображения области действий.
Открытое свойство LayoutEngine Получает кэшированный экземпляр обработчика макета элемента управления "Область действий".
Открытое свойство Left Получает или задает расстояние (в пикселях) между левой границей элемента управления панели действий и левой границей клиентской области его контейнера.
Открытое свойство Location Получает или задает координаты левого верхнего угла панели действий относительно левого верхнего угла ее контейнера.
Открытое свойство Margin Возвращает или задает пустое пространство между элементами управления.
Открытое свойство MaximumSize Возвращает или задает размер, являющийся верхней границей, которую может указать метод GetPreferredSize.
Открытое свойство MinimumSize Возвращает или задает размер, являющийся нижней границей, которую может указать метод GetPreferredSize.
Открытое свойство Name Получает или задает имя элемента управления области действий.
Открытое свойство Orientation Получает значение, указывающее ориентацию (горизонтальную или вертикальную) панели действий.
Открытое свойство Padding Получает или задает заполнение в области действий.
Открытое свойство Parent Получает или задает родительский контейнер области действий.
Открытое свойство ParentForm Инфраструктура. Это свойство не поддерживается панелью действий.
Открытое свойство PreferredSize Получает размер прямоугольной области, в которую можно вписать область действий.
Открытое свойство ProductName Получает имя продукта сборки, содержащей область действий.
Открытое свойство ProductVersion Получает версию сборки, содержащую область действий.
Открытое свойство RecreatingHandle Получает значение, указывающее, осуществляется ли в данный момент повторное создание дескриптора элемента управления области действий.
Открытое свойство Region Получает или задает область окна, связанную с областью действий.
Открытое свойство Right Получает расстояние (в пикселях) между правой границей панели действий и левой границей клиентской области ее контейнера.
Открытое свойство RightToLeft Получает или задает значение, указывающее, выровнены ли элементы области действий для поддержки языков, использующих шрифты с написанием справа налево.
Открытое свойство Site Получает или задает сайт области действий.
Открытое свойство Size Получает или задает высоту и ширину элемента управления области действий.
Открытое свойство StackOrder Возвращает или задает значение, обозначающее, в каком направлении элементы управления добавляются в панели действий.
Открытое свойство TabIndex Получает или задает последовательность табуляции панели действий внутри ее контейнера.
Открытое свойство TabStop Получает или задает значение, указывающее, может ли пользователь предоставить фокус панели действий с помощью клавиши TAB.
Открытое свойство Tag Получает или задает объект, содержащий данные о панели действий.
Открытое свойство Text Инфраструктура. Это свойство не поддерживается панелью действий.
Открытое свойство Top Получает или задает расстояние (в пикселях) между верхней границей элемента управления панели действий и верхней границей клиентской области его контейнера.
Открытое свойство TopLevelControl Инфраструктура. Это свойство не поддерживается панелью действий.
Открытое свойство UseWaitCursor Получает или задает значение, указывающее, следует ли использовать курсор ожидания для панели действий и всех дочерних элементов управления.
Открытое свойство VerticalScroll Получает характеристики, связанные с вертикальной полосой прокрутки.
Открытое свойство Visible Возвращает или задает значение, указывающее, отображается ли панель ActionsPane.
Открытое свойство Width Получает или задает ширину элемента управления области действий.
Открытое свойство WindowTarget Инфраструктура. Это свойство не поддерживается панелью действий.

В начало страницы

Методы

  Имя Описание
Открытый метод BeginInit Инфраструктура.
Открытый метод BeginInvoke(Delegate) Выполняет указанный делегат асинхронно в потоке, в котором был создан базовый дескриптор элемента управления панели действий.
Открытый метод BeginInvoke(Delegate, array<Object[]) Выполняет указанный делегат асинхронно с указанными аргументами в потоке, в котором был создан базовый дескриптор элемента управления панели действий.
Открытый метод BringToFront Помещает элемент управления панели действий в начало z-порядка.
Открытый метод Clear Отсоединяет панель действий от документа.
Открытый метод Contains Возвращает значение, указывающее, является ли заданный элемент управления дочерним элементом панели действий.
Открытый метод CreateControl Вызывает принудительное создание видимого элемента управления "Панель действий", включая создание дескриптора и всех видимых дочерних элементов.
Открытый метод CreateGraphics Создает объект Graphics для элемента управления "Область действий".
Открытый метод Dispose Выполняет определяемые приложением задачи, связанные с высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable.)
Открытый метод DoDragDrop Начинает операцию перетаскивания.
Открытый метод DrawToBitmap Поддерживает отрисовку в указанном точечном рисунке.
Открытый метод EndInit Инфраструктура.
Открытый метод EndInvoke Получает возвращаемое значение заданной асинхронной операции.
Открытый метод FindForm Получает форму, в которой находится элемент управления панели действий.
Открытый метод Focus Устанавливает фокус ввода на панели действий.
Открытый метод GetChildAtPoint(Point) Получает дочерний элемент управления, имеющий указанные координаты.
Открытый метод GetChildAtPoint(Point, GetChildAtPointSkip) Получает дочерний элемент управления, расположенный по указанным координатам, определяя, следует ли игнорировать дочерние элементы управления конкретного типа.
Открытый метод GetContainerControl Возвращает следующий объект ContainerControl в цепочке родительских элементов управления данного элемента.
Открытый метод GetNextControl Извлекает следующий или предыдущий элемент управления в последовательности табуляции дочерних элементов управления.
Открытый метод GetPreferredSize Извлекает размер прямоугольной области, в которую помещается панель действий.
Открытый метод Hide Удаляет панель ActionsPane и элементы управления с панели задач интерфейса пользователя, но панель задач остается видимой.
Открытый метод Invalidate() Делает недействительной всю поверхность области действий и вызывает перерисовку области действий.
Открытый метод Invalidate(Boolean) Объявляет недействительной всю поверхность области действий и вызывает отправку сообщения рисования в область действий.При необходимости объявляет недействительными назначенные панели действий дочерние элементы.
Открытый метод Invalidate(Rectangle) Объявляет недействительным заданный регион панели действий (добавляет его в область обновления панели действий — область, которая будет перекрашена во время следующей операции закрашивания) и отправляет сообщение о закрашивании на панель действий.
Открытый метод Invalidate(Region) Объявляет недействительным заданный регион панели действий (добавляет его в область обновления панели действий — область, которая будет перекрашена во время следующей операции закрашивания) и отправляет сообщение о закрашивании на панель действий.
Открытый метод Invalidate(Rectangle, Boolean) Объявляет недействительным заданный регион панели действий (добавляет его в область обновления панели действий — область, которая будет перекрашена во время следующей операции закрашивания) и отправляет сообщение о закрашивании на панель действий.При необходимости объявляет недействительными назначенные панели действий дочерние элементы.
Открытый метод Invalidate(Region, Boolean) Объявляет недействительным заданный регион панели действий (добавляет его в область обновления панели действий — область, которая будет перекрашена во время следующей операции закрашивания) и отправляет сообщение о закрашивании на панель действий.При необходимости объявляет недействительными назначенные панели действий дочерние элементы.
Открытый метод Invoke(Delegate) Выполняет указанный делегат в том потоке, которому принадлежит базовый дескриптор окна панели действий.
Открытый метод Invoke(Delegate, array<Object[]) Выполняет указанный делегат в том потоке, которому принадлежит базовый дескриптор окна панели действий, с указанным списком аргументов.
Открытый метод PerformAutoScale Выполняет масштабирование панели действий и ее дочерних объектов.
Открытый метод PerformLayout() Вызывает в панели действий принудительное применение логики макета ко всем ее дочерним элементам управления.
Открытый метод PerformLayout(Control, String) Вызывает в панели действий принудительное применение логики макета ко всем ее дочерним элементам управления.
Открытый метод PointToClient Вычисляет местоположение указанной точки экрана в клиентских координатах.
Открытый метод PointToScreen Вычисляет местоположение указанной точки клиента в экранных координатах.
Открытый метод PreProcessControlMessage Выполняет предварительную обработку клавиатурных или входящих сообщений в цикле обработки сообщений перед их отправкой.
Открытый метод PreProcessMessage Выполняет предварительную обработку клавиатурных или входящих сообщений в цикле обработки сообщений перед их отправкой.
Открытый метод RectangleToClient Вычисляет размер и местоположение указанной прямоугольной области экрана в клиентских координатах.
Открытый метод RectangleToScreen Вычисляет размер и местоположение указанной клиентской области (в виде прямоугольника) в экранных координатах.
Открытый метод Refresh Принудительно создает условия, при которых панель действий делает недоступной свою клиентскую область и немедленно перерисовывает себя и все дочерние элементы управления.
Открытый метод ResetBackColor Инфраструктура. Этот метод не поддерживается панелью действий.
Открытый метод ResetBindings Инфраструктура. Этот метод не поддерживается панелью действий.
Открытый метод ResetCursor Инфраструктура. Этот метод не поддерживается панелью действий.
Открытый метод ResetFont Инфраструктура. Этот метод не поддерживается панелью действий.
Открытый метод ResetForeColor Инфраструктура. Этот метод не поддерживается панелью действий.
Открытый метод ResetImeMode Инфраструктура. Этот метод не поддерживается панелью действий.
Открытый метод ResetRightToLeft Инфраструктура. Этот метод не поддерживается панелью действий.
Открытый метод ResetText Инфраструктура. Этот метод не поддерживается панелью действий.
Открытый метод ResumeLayout() Возобновляет обычную логику макета.
Открытый метод ResumeLayout(Boolean) Возобновляет обычную логику макета, дополнительно осуществляя немедленное отображение отложенных запросов макета.
Открытый метод Scale Масштабирует панель действий и любые ее дочерние элементы с использованием заданного коэффициента масштабирования.
Открытый метод ScrollControlIntoView Прокручивает заданный дочерний элемент управления в видимую область.
Открытый метод Select Активирует панель действий.
Открытый метод SelectNextControl Активирует следующий элемент управления.
Открытый метод SendToBack Отправляет элемент управления панели действий в конец z-порядка.
Открытый метод SetAutoScrollMargin Возвращает или задает размеры полей для автоматической прокрутки.
Открытый метод SetBounds(Int32, Int32, Int32, Int32) Задает границы панели действий для указанного местоположения и размера.
Открытый метод SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified) Задает заданные границы панели действий для указанного местоположения и размера.
Открытый метод Show Отображает панель ActionsPane в панели задач, включая все элементы управления, добавленные на панель ActionsPane, но не отображает панель задач, если она невидима.
Открытый метод SuspendLayout Временно приостанавливает логику макета для панели действий.
Открытый метод Update Вызывает перерисовку панелью действий недопустимых областей в клиентской области.
Открытый метод Validate() Проверяет содержимое панели действий, вызывая события Validating и Validated в указанной последовательности.
Открытый метод Validate(Boolean) Проверяет содержимое панели действий; условно зависит от того, включена ли автоматическая проверка.
Открытый метод ValidateChildren() Заставляет все дочерние элементы управления, поддерживающие проверку, проверить свои данные.
Открытый метод ValidateChildren(ValidationConstraints) Заставляет все дочерние элементы управления, поддерживающие проверку, проверить свои данные.

В начало страницы

События

  Имя Описание
Открытое событие AutoSizeChanged Инфраструктура. Это событие не поддерживается панелью действий.
Открытое событие AutoValidateChanged Происходит при изменении свойства AutoValidate.
Открытое событие BackColorChanged Происходит при изменении значения свойства BackColor.
Открытое событие BackgroundImageChanged Происходит при изменении значения свойства BackgroundImage.
Открытое событие BackgroundImageLayoutChanged Происходит при изменении свойства BackgroundImageLayout.
Открытое событие BindingContextChanged Происходит при изменении значения свойства BindingContext.
Открытое событие CausesValidationChanged Происходит при изменении значения свойства CausesValidation.
Открытое событие ChangeUICues Происходит при изменении фокуса или клавиатурных подсказок пользовательского интерфейса.
Открытое событие Click Происходит щелчке мышью в области действий.
Открытое событие ClientSizeChanged Происходит при изменении значения свойства ClientSize.
Открытое событие ContextMenuChanged Происходит при изменении значения свойства ContextMenu.
Открытое событие ContextMenuStripChanged Происходит при изменении значения свойства ContextMenuStrip.
Открытое событие ControlAdded Происходит при добавлении нового элемента управления к коллекции Controls.
Открытое событие ControlRemoved Происходит при удалении элемента управления из коллекции Controls.
Открытое событие CursorChanged Происходит при изменении значения свойства Cursor.
Открытое событие Disposed Происходит при удалении панели действий.
Открытое событие DockChanged Происходит при изменении значения свойства Dock.
Открытое событие DoubleClick Происходит при двойном щелчке мышью в области действий.
Открытое событие DragDrop Происходит по завершении операции перетаскивания.
Открытое событие DragEnter Происходит при перетаскивании объекта в пространство области действий.
Открытое событие DragLeave Происходит при перетаскивании объекта за пределы области действий.
Открытое событие DragOver Происходит при перетаскивании объекта в пространстве области действий.
Открытое событие EnabledChanged Происходит, если значение свойства Enabled было изменено.
Открытое событие Enter Происходит при входе в область действий.
Открытое событие FontChanged Происходит при изменении значения свойства Font.
Открытое событие ForeColorChanged Происходит при изменении значения свойства ForeColor.
Открытое событие GiveFeedback Генерируется при выполнении операции перетаскивания.
Открытое событие GotFocus Происходит, когда область действий получает фокус.
Открытое событие HandleCreated Происходит при создании дескриптора для области действий.
Открытое событие HandleDestroyed Происходит в процессе удаления дескриптора области действий.
Открытое событие HelpRequested Происходит, когда пользователь запрашивает справку области действий.
Открытое событие ImeModeChanged Происходит при изменении свойства ImeMode.
Открытое событие Invalidated Происходит, когда требуется перерисовать отображение области действий.
Открытое событие KeyDown Происходит при нажатии клавиши, когда панель действий имеет фокус.
Открытое событие KeyPress Происходит при нажатии клавиши, когда панель действий имеет фокус.
Открытое событие KeyUp Происходит при отпускании клавиши, когда панель действий имеет фокус.
Открытое событие Layout Происходит, когда необходимо изменить позицию дочерних элементов управления области действий.
Открытое событие Leave Происходит при перемещении фокуса ввода за пределы области действий.
Открытое событие Load Происходит перед тем, как область действий первый раз становится видимой.
Открытое событие LocationChanged Происходит, если значение свойства Location было изменено.
Открытое событие LostFocus Происходит, когда область действий теряет фокус.
Открытое событие MarginChanged Происходит при изменении границ области действий.
Открытое событие MouseCaptureChanged Происходит, когда область действий теряет или получает захват мыши.
Открытое событие MouseClick Происходит при щелчке мышью в области действий.
Открытое событие MouseDoubleClick Происходит при двойном щелчке мышью в области действий.
Открытое событие MouseDown Происходит при нажатии кнопки мыши, если указатель мыши находится на панели действий.
Открытое событие MouseEnter Происходит, когда указатель мыши оказывается в области действий.
Открытое событие MouseHover Происходит, когда указатель мыши находится в области действий.
Открытое событие MouseLeave Происходит, когда указатель мыши перемещается за пределы области действий.
Открытое событие MouseMove Происходит, когда указатель мыши перемещается в области действий.
Открытое событие MouseUp Происходит при отпускании кнопки мыши, когда указатель мыши находится на панели действий.
Открытое событие MouseWheel Генерируется при движении колесика мыши, если панель действий имеет фокус.
Открытое событие Move Происходит при перемещении области действий.
Открытое событие OrientationChanged Происходит при изменении значения свойства Orientation панели действий.
Открытое событие PaddingChanged Происходит при изменении заполнения области действий.
Открытое событие Paint Происходит при перерисовке области действий.
Открытое событие ParentChanged Происходит при изменении значения свойства Parent.
Открытое событие PreviewKeyDown Генерируется перед событием KeyDown при нажатии клавиши, когда элемент управления имеет фокус.
Открытое событие QueryAccessibilityHelp Происходит при предоставлении справки объектом AccessibleObject для приложений со специальными возможностями.
Открытое событие QueryContinueDrag Происходит во время операции перетаскивания и позволяет источнику перетаскивания определить, следует ли отменить эту операцию.
Открытое событие RegionChanged Происходит при изменении значения свойства Region.
Открытое событие Resize Происходит при изменении размера области действий.
Открытое событие RightToLeftChanged Происходит при изменении значения свойства RightToLeft.
Открытое событие Scroll Происходит в том случае, если пользователь или программа выполняет прокрутку в клиентской области.
Открытое событие SizeChanged Происходит при изменении значения свойства Size.
Открытое событие StyleChanged Происходит при изменении стиля панели действий.
Открытое событие SystemColorsChanged Происходит при изменении системных цветов.
Открытое событие TabIndexChanged Происходит при изменении значения свойства TabIndex.
Открытое событие TabStopChanged Происходит при изменении значения свойства TabStop.
Открытое событие TextChanged Инфраструктура. Это событие не поддерживается панелью действий.
Открытое событие Validated Происходит при завершении проверки области действий.
Открытое событие Validating Происходит, когда область действий выполняет проверку.
Открытое событие VisibleChanged Происходит при изменении значения свойства Visible.

В начало страницы

Заметки

Все настройки уровня документа для Excel или Word предоставляют объект ActionsPane. Этот объект можно использовать для настройки пользовательского интерфейса области задач Действия с документами в проекте уровня документа. Чтобы получить объект ActionsPane, воспользуйтесь полем ActionsPane класса ThisDocument (для Word) или класса ThisWorkbook (для Excel) в проекте. Дополнительные сведения см. в разделе Общие сведения о панели действий.

Каждый объект ActionsPane расширяет базовый объект UserControl Windows Forms, предоставляющий пользовательский интерфейс, который можно настроить. Большинство членов ActionsPane соответствуют членам базового UserControl. Используйте следующие элементы ActionsPane, чтобы получить доступ к функциональным возможностям данной панели действий:

  • Clear. Этот метод используется для отсоединения панель действий из документа или книги.

  • Свойство AutoRecover. Это свойство используется, чтобы запретить или разрешить конечным пользователям отсоединять панель действий из документа или книги.

  • Свойство Orientation. Это свойство позволяет определить место закрепления панели действий: справа, слева, сверху или снизу в книге.

  • Свойство StackOrder. Используйте это свойство, чтобы указать направление, в котором элементы управления располагаются в панели действий.

  • Событие OrientationChanged. Это свойство используется для определения, когда панель действий закрепляется в другое место.

Примечание

Данный интерфейс реализован средствами Visual Studio Tools для среды выполнения Office. Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

Использование

В настоящей документации описывается версия данного типа, которая используется в проектах Office, предназначенных для платформы .NET Framework 4. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены и примеры, предназначенные для данного типа, могут не работать. Документацию о данном типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Примеры

В следующем примере кода демонстрируется, как создать простую панель действий и настроить автоматическое выравнивание ее содержимого. Если пользователь меняет ориентацию панели действий, перемещая ее в другую часть окна приложения, или щелкает элемент управления Button в панели действий, используется свойство Orientation для определения нового значения свойства StackOrder. Для выполнения этого кода, вызовите метод InitActionsPane из обработчика событий ThisWorkbook_Startup проекта уровня документа для Excel.

Private Sub InitActionsPane()
    With Globals.ThisWorkbook.ActionsPane
        .Clear()
        .Visible = True
        .AutoRecover = True
    End With

    AddHandler Globals.ThisWorkbook.ActionsPane.OrientationChanged, _
        AddressOf ActionsPane_OrientationChanged
    ResetStackOrder()

    ' Create the button that will update the stack order.
    Dim button1 As New Button()
    button1.Text = "Change stack order"
    AddHandler button1.Click, AddressOf button1_Click

    ' Create two more buttons that do nothing.
    Dim button2 As New Button()
    button2.Text = "Button 2"
    Dim button3 As New Button()
    button3.Text = "Button 3"

    Globals.ThisWorkbook.ActionsPane.Controls.AddRange(New Control() _
        {button1, button2, button3})
End Sub

' Switch the stack order according to the current orientation.
Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs)

    If Globals.ThisWorkbook.ActionsPane.Orientation = _
        Orientation.Horizontal Then

        If Globals.ThisWorkbook.ActionsPane.StackOrder = _
            Microsoft.Office.Tools.StackStyle.FromLeft Then
            Globals.ThisWorkbook.ActionsPane.StackOrder = _
                Microsoft.Office.Tools.StackStyle.FromRight
        Else
            Globals.ThisWorkbook.ActionsPane.StackOrder = _
                Microsoft.Office.Tools.StackStyle.FromLeft
        End If
    Else
        If Globals.ThisWorkbook.ActionsPane.StackOrder = _
            Microsoft.Office.Tools.StackStyle.FromTop Then
            Globals.ThisWorkbook.ActionsPane.StackOrder = _
                Microsoft.Office.Tools.StackStyle.FromBottom
        Else
            Globals.ThisWorkbook.ActionsPane.StackOrder = _
                Microsoft.Office.Tools.StackStyle.FromTop
        End If
    End If
End Sub

Private Sub ActionsPane_OrientationChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    ResetStackOrder()
End Sub

' Readjust the stack order so that it matches the current orientation.
Sub ResetStackOrder()
    If Globals.ThisWorkbook.ActionsPane.Orientation = _
        Orientation.Horizontal Then

        If (Globals.ThisWorkbook.ActionsPane.StackOrder = _
        Microsoft.Office.Tools.StackStyle.FromTop Or _
        Globals.ThisWorkbook.ActionsPane.StackOrder = _
        Microsoft.Office.Tools.StackStyle.FromBottom) Then
            Globals.ThisWorkbook.ActionsPane.StackOrder = _
                Microsoft.Office.Tools.StackStyle.FromLeft
        End If
    End If

    If Globals.ThisWorkbook.ActionsPane.Orientation = _
        Orientation.Vertical Then

        If (Globals.ThisWorkbook.ActionsPane.StackOrder = _
        Microsoft.Office.Tools.StackStyle.FromLeft Or _
        Globals.ThisWorkbook.ActionsPane.StackOrder = _
        Microsoft.Office.Tools.StackStyle.FromRight) Then
            Globals.ThisWorkbook.ActionsPane.StackOrder = _
                Microsoft.Office.Tools.StackStyle.FromTop
        End If
    End If
End Sub
private void InitActionsPane()
{
    Globals.ThisWorkbook.ActionsPane.Clear();
    Globals.ThisWorkbook.ActionsPane.Visible = true;
    Globals.ThisWorkbook.ActionsPane.AutoRecover = true;
    Globals.ThisWorkbook.ActionsPane.OrientationChanged +=
        new EventHandler(ActionsPane_OrientationChanged);
    ResetStackOrder();

    // Create the button that will update the stack order.
    Button button1 = new Button();
    button1.Text = "Change stack order";
    button1.Click += new EventHandler(button1_Click);

    // Create two more buttons that do nothing.
    Button button2 = new Button();
    button2.Text = "Button 2";
    Button button3 = new Button();
    button3.Text = "Button 3";

    Globals.ThisWorkbook.ActionsPane.Controls.AddRange(
        new Control[] { button1, button2, button3 });
}

// Switch the stack order according to the current orientation.
void button1_Click(object sender, EventArgs e)
{
    if (Globals.ThisWorkbook.ActionsPane.Orientation == 
        Orientation.Horizontal)
    {
        if (Globals.ThisWorkbook.ActionsPane.StackOrder == 
            Microsoft.Office.Tools.StackStyle.FromLeft)
        {
            Globals.ThisWorkbook.ActionsPane.StackOrder =
                Microsoft.Office.Tools.StackStyle.FromRight;
        }
        else
        {
            Globals.ThisWorkbook.ActionsPane.StackOrder =
                Microsoft.Office.Tools.StackStyle.FromLeft;
        }
    }
    else
    {
        if (Globals.ThisWorkbook.ActionsPane.StackOrder ==
            Microsoft.Office.Tools.StackStyle.FromTop)
        {
            Globals.ThisWorkbook.ActionsPane.StackOrder =
                Microsoft.Office.Tools.StackStyle.FromBottom;
        }
        else
        {
            Globals.ThisWorkbook.ActionsPane.StackOrder =
                Microsoft.Office.Tools.StackStyle.FromTop;
        }
    }
}

void ActionsPane_OrientationChanged(object sender, EventArgs e)
{
    ResetStackOrder();
}

// Readjust the stack order so that it matches the current orientation.
void ResetStackOrder()
{
    if (Globals.ThisWorkbook.ActionsPane.Orientation == 
        Orientation.Horizontal &&
       (Globals.ThisWorkbook.ActionsPane.StackOrder == 
           Microsoft.Office.Tools.StackStyle.FromTop ||
        Globals.ThisWorkbook.ActionsPane.StackOrder ==
           Microsoft.Office.Tools.StackStyle.FromBottom))
    {
        Globals.ThisWorkbook.ActionsPane.StackOrder =
            Microsoft.Office.Tools.StackStyle.FromLeft;
    }

    if (Globals.ThisWorkbook.ActionsPane.Orientation == 
        Orientation.Vertical &&
       (Globals.ThisWorkbook.ActionsPane.StackOrder ==
           Microsoft.Office.Tools.StackStyle.FromLeft ||
        Globals.ThisWorkbook.ActionsPane.StackOrder ==
           Microsoft.Office.Tools.StackStyle.FromRight))
    {
        Globals.ThisWorkbook.ActionsPane.StackOrder =
            Microsoft.Office.Tools.StackStyle.FromTop;
    }
}

См. также

Ссылки

Microsoft.Office.Tools - пространство имен

Другие ресурсы

Общие сведения о панели действий

Журнал изменений

Дата

Журнал

Причина

Май 2010

Добавлены сведения о членах, описания параметров и возвращаемые значения для соответствующих членов Windows Forms.

Улучшение информации.