Макрокоманда SetProperty

Область применения: Access 2013, Office 2013

С помощью действия SetProperty можно задать свойство элемента управления в форме или отчете.

Setting

Аргументы действия SetProperty приведены ниже.

Аргумент макрокоманды

Описание

Контрольное имя

Введите имя поля или элемента управления, для которого требуется задать значение свойства. Используйте только имя элемента управления, а не полный синтаксис. Оставьте этот аргумент пустым, чтобы задать свойство для текущей формы или отчета.

Property

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

Значение

Введите значение, которое должно быть задано свойству. Для свойств со значениями "Да" или "Нет" используйте значение -1 для параметра Да и 0 для "Нет".

Примечания

  • С помощью действия SetProperty можно задать следующие свойства элемента управления: Enabled, Visible, Locked, Left, Top, Width, Height, Fore Color, Back Color или Caption.

  • Если ввести недопустимое значение для аргумента Value , ошибка не возникает, но Access может изменить свойство на другое значение в зависимости от того, как он интерпретирует аргумент.

  • Действие SetProperty можно использовать в автономном макросе только в том случае, если перед ним следует выбрать форму или отчет, содержащий элемент управления, для которого задается свойство . Если форма или отчет не открыты, можно использовать действие OpenForm или OpenReport , чтобы открыть и выбрать его. Если форма или отчет уже открыты, можно выбрать его с помощью действия SelectObject . Затем можно использовать действие SetProperty , чтобы задать свойство . Выбор объекта не требуется, если вы используете действие SetProperty в макросе, который внедрен в элемент управления в той же форме или отчете, что и элемент управления, для которого задается свойство.

  • Чтобы выполнить действие SetProperty в модуле VBA, используйте метод SetProperty объекта DoCmd .

Пример

В следующем примере показано, как использовать действие SetProperty для переключения видимости текстового поля MyTextBox .

Пример кода изсправочника программиста Microsoft Access 2010, русская версия.

    Submacro: TestVisible
        SetProperty
            Control Name Text40
            Property Visible
            Value =Not[Text40].[Visible]
    End Submacro