AdornerProvider.Activate - метод

Статья
11/05/2008

Обновлен: Ноябрь 2007

Вызывается, когда конструктор впервые запрашивает декоративные элементы.

Пространство имен: Microsoft.Windows.Design.Interaction
Сборка: Microsoft.Windows.Design.Extensibility (в Microsoft.Windows.Design.Extensibility.dll)

Синтаксис

'Декларация
Protected Overridable Sub Activate ( _
    item As ModelItem, _
    view As DependencyObject _
)
'Применение
Dim item As ModelItem
Dim view As DependencyObject

Me.Activate(item, view)

protected virtual void Activate(
    ModelItem item,
    DependencyObject view
)

protected:
virtual void Activate(
    ModelItem^ item, 
    DependencyObject^ view
)

protected function Activate(
    item : ModelItem, 
    view : DependencyObject
)

Параметры

item
Тип: Microsoft.Windows.Design.Model.ModelItem
Объект ModelItem, представляющий декорируемый элемент.

view
Тип: System.Windows.DependencyObject
Экземпляр декорируемого элемента.

Исключения

Исключение	Условие
ArgumentNullException	Параметр view имеет значение nullссылка null (Nothing в Visual Basic).

Заметки

Для инициализации декоративных элементов поставщик декоративных элементов может использовать декорируемый элемент или представление. Если этот контекст необязателен, то поставщик декоративного элемента может создавать декоративные элементы в конструкторе, не нуждаясь в перегрузке метода Activate. Этот метод вызывается до того, как декоративные элементы станут дочерними по отношению к пользовательскому интерфейсу конструктора.

Экземпляр AdornerProvider может быть активирован и деактивирован несколько раз в течение своего жизненного цикла. Для этого следует соответствующим образом реализовать методы Activate и Deactivate.

Примеры

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

' The following method is called when the adorner is activated.
' It creates the adorner control, sets up the adorner panel,
' and attaches a ModelItem to the adorned control.
Protected Overrides Sub Activate(ByVal item As ModelItem, ByVal view As DependencyObject)

    ' Save the ModelItem and hook into when it changes.
    ' This enables updating the slider position when 
    ' a new Background value is set.
    adornedControlModel = item
    AddHandler adornedControlModel.PropertyChanged, AddressOf AdornedControlModel_PropertyChanged

    ' Setup the slider's min and max values.
    opacitySlider.Minimum = 0
    opacitySlider.Maximum = 1

    ' Setup the adorner panel.
    ' All adorners are placed in an AdornerPanel
    ' for sizing and layout support.
    Dim myPanel = Me.Panel

    AdornerPanel.SetHorizontalStretch(opacitySlider, AdornerStretch.Stretch)
    AdornerPanel.SetVerticalStretch(opacitySlider, AdornerStretch.None)

    Dim placement As New AdornerPlacementCollection()

    ' The adorner's width is relative to the content.
    ' The slider extends the full width of the control it adorns.
    placement.SizeRelativeToContentWidth(1.0, 0)

    ' The adorner's height is the same as the slider's.
    placement.SizeRelativeToAdornerDesiredHeight(1.0, 0)

    ' Position the adorner above the control it adorns.
    placement.PositionRelativeToAdornerHeight(-1.0, 0)

    ' Position the adorner up 5 pixels. This demonstrates 
    ' that these placement calls are additive. These two calls
    ' are equivalent to the following single call:
    ' PositionRelativeToAdornerHeight(-1.0, -5).
    placement.PositionRelativeToAdornerHeight(0, -5)

    AdornerPanel.SetPlacements(opacitySlider, placement)

    ' Initialize the slider when it is loaded.
    AddHandler opacitySlider.Loaded, AddressOf slider_Loaded

    ' Handle the value changes of the slider control.
    AddHandler opacitySlider.ValueChanged, AddressOf slider_ValueChanged

    AddHandler opacitySlider.PreviewMouseLeftButtonUp, _
        AddressOf slider_MouseLeftButtonUp

    AddHandler opacitySlider.PreviewMouseLeftButtonDown, _
        AddressOf slider_MouseLeftButtonDown

    MyBase.Activate(item, view)

End Sub

' The Panel utility property demand-creates the 
' adorner panel and adds it to the provider's 
' Adorners collection.
Public ReadOnly Property Panel() As AdornerPanel
    Get
        If Me.opacitySliderAdornerPanel Is Nothing Then
            Me.opacitySliderAdornerPanel = New AdornerPanel()

            ' Add the adorner to the adorner panel.
            Me.opacitySliderAdornerPanel.Children.Add(opacitySlider)

            ' Add the panel to the Adorners collection.
            Adorners.Add(opacitySliderAdornerPanel)
        End If

        Return Me.opacitySliderAdornerPanel
    End Get
End Property

// The following method is called when the adorner is activated.
// It creates the adorner control, sets up the adorner panel,
// and attaches a ModelItem to the adorned control.
protected override void Activate(ModelItem item, DependencyObject view)
{
    // Save the ModelItem and hook into when it changes.
    // This enables updating the slider position when 
    // a new Background value is set.
    adornedControlModel = item;
    adornedControlModel.PropertyChanged += 
        new System.ComponentModel.PropertyChangedEventHandler(
            AdornedControlModel_PropertyChanged);

    // Setup the slider's min and max values.
    opacitySlider.Minimum = 0;
    opacitySlider.Maximum = 1;

    // Setup the adorner panel.
    // All adorners are placed in an AdornerPanel
    // for sizing and layout support.
    AdornerPanel myPanel = this.Panel;

    AdornerPanel.SetHorizontalStretch(opacitySlider, AdornerStretch.Stretch);
    AdornerPanel.SetVerticalStretch(opacitySlider, AdornerStretch.None);

    AdornerPlacementCollection placement = new AdornerPlacementCollection();

    // The adorner's width is relative to the content.
    // The slider extends the full width of the control it adorns.
    placement.SizeRelativeToContentWidth(1.0, 0);

    // The adorner's height is the same as the slider's.
    placement.SizeRelativeToAdornerDesiredHeight(1.0, 0);

    // Position the adorner above the control it adorns.
    placement.PositionRelativeToAdornerHeight(-1.0, 0);

    // Position the adorner up 5 pixels. This demonstrates 
    // that these placement calls are additive. These two calls
    // are equivalent to the following single call:
    // PositionRelativeToAdornerHeight(-1.0, -5).
    placement.PositionRelativeToAdornerHeight(0, -5);

    AdornerPanel.SetPlacements(opacitySlider, placement);

    // Initialize the slider when it is loaded.
    opacitySlider.Loaded += new RoutedEventHandler(slider_Loaded);

    // Handle the value changes of the slider control.
    opacitySlider.ValueChanged += 
        new RoutedPropertyChangedEventHandler<double>(
            slider_ValueChanged);

    opacitySlider.PreviewMouseLeftButtonUp += 
        new System.Windows.Input.MouseButtonEventHandler(
            slider_MouseLeftButtonUp);

    opacitySlider.PreviewMouseLeftButtonDown += 
        new System.Windows.Input.MouseButtonEventHandler(
            slider_MouseLeftButtonDown);

    base.Activate(item, view);
}

// The Panel utility property demand-creates the 
// adorner panel and adds it to the provider's 
// Adorners collection.
public AdornerPanel Panel 
{ 
    get
    {
        if (this.opacitySliderAdornerPanel == null)
        {
            opacitySliderAdornerPanel = new AdornerPanel();

            opacitySliderAdornerPanel.Children.Add(opacitySlider);

            // Add the panel to the Adorners collection.
            Adorners.Add(opacitySliderAdornerPanel);
        }

        return this.opacitySliderAdornerPanel;
    } 
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.