FrameworkElement.Margin Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml

Возвращает или задает внешнее поле объекта FrameworkElement.

public:
 property Thickness Margin { Thickness get(); void set(Thickness value); };

Thickness Margin();

void Margin(Thickness value);

public Thickness Margin { get; set; }

var thickness = frameworkElement.margin;
frameworkElement.margin = thickness;

Public Property Margin As Thickness

<frameworkElement Margin="uniform"/>
- or -
<frameworkElement Margin="left+right,top+bottom"/>
- or -
<frameworkElement Margin="left,top,right,bottom"/>
 

Значение свойства

Thickness

Предоставляет значения полей для объекта . Значением по умолчанию является толщина по умолчанию со всеми свойствами (измерениями), равными 0.

Примеры

Этот пример задает Margin в коде как часть более крупного сценария создания элемента пользовательского интерфейса во время выполнения, а затем задания различных свойств, связанных с макетом. Это часто делается перед добавлением нового элемента в дерево объектов существующей страницы пользовательского интерфейса XAML. В этом случае несколько свойств Margin задаются с помощью новой толщины , созданной с помощью конструктора универсального значения.

    public Page()
    {
        InitializeComponent();
        LayoutDesign();
    }

    private void LayoutDesign()
    {
        //Create Stackpanel for ListBox Control and its description
        StackPanel DeptStackPanel = new StackPanel();
        DeptStackPanel.Margin = new Thickness(10);

        LayoutRoot.Children.Add(DeptStackPanel);
        Grid.SetColumn(DeptStackPanel, 1);
        Grid.SetRow(DeptStackPanel, 1);

        TextBlock DeptListHeading = new TextBlock();
        DeptListHeading.Text = "Department";

        ListBox DeptList = new ListBox();
        DeptList.Items.Add("Finance");
        DeptList.Items.Add("Marketing");
        DeptList.Items.Add("Human Resources");
        DeptList.Items.Add("Payroll");

        DeptStackPanel.Children.Add(DeptListHeading);
        DeptStackPanel.Children.Add(DeptList);

        //Create StackPanel for buttons
        StackPanel ButtonsStackPanel = new StackPanel();
        ButtonsStackPanel.Margin = new Thickness(10);
        ButtonsStackPanel.Orientation = Orientation.Horizontal;
        ButtonsStackPanel.HorizontalAlignment = HorizontalAlignment.Center;

        LayoutRoot.Children.Add(ButtonsStackPanel);
        Grid.SetColumn(ButtonsStackPanel, 0);
        Grid.SetRow(ButtonsStackPanel, 2);
        Grid.SetColumnSpan(ButtonsStackPanel, 2);

        Button BackButton = new Button();
        BackButton.Content = "Back";
        BackButton.Width = 100;

        Button CancelButton = new Button();
        CancelButton.Content = "Cancel";
        CancelButton.Width = 100;

        Button NextButton = new Button();
        NextButton.Content = "Next";
        NextButton.Width = 100;

        ButtonsStackPanel.Children.Add(BackButton);
        ButtonsStackPanel.Children.Add(CancelButton);
        ButtonsStackPanel.Children.Add(NextButton);

        BackButton.Margin = new Thickness(10);
        CancelButton.Margin = new Thickness(10);
        NextButton.Margin = new Thickness(10);
    }
}

Комментарии

Поведение полей и макет

Значение поля больше, чем 0 применяет пространство за пределами Объектов ActualWidth и ActualHeight.

Поля являются аддитивными для одноранговых объектов в макете; Например, два горизонтально или вертикально смежных 30 объекта с полем, заданным на прилегающей границе, будут иметь 60 пикселей пространства между ними.

Объекты с заданными полями, как правило, не ограничивают размер указанного поля Margin, если выделенного прямоугольного пространства недостаточно для поля и области содержимого объекта. Область содержимого будет ограничена при вычислении макета. Единственный случай, когда поля будут ограничены, это если содержимое уже ограничено до нуля. Однако это поведение в конечном счете управляется конкретным типом, который интерпретирует Margin, а также контейнером макета этого объекта.

Отрицательные значения для измерений полей разрешены, но их следует использовать с осторожностью (и помните, что отрицательные поля могут интерпретироваться по-разному различными реализациями макета класса). Отрицательные поля обычно обрезают содержимое объекта в этом направлении.

Нецелевых значений для значений полей технически разрешено, но, как правило, их следует избегать.

Поля и заполнение

Связанная концепция — заполнение. Для объекта и его ограничивающего прямоугольника поле — это дополнительное пространство, которое выделяется за пределами ограничивающего прямоугольника, когда элемент пользовательского интерфейса содержится и отрисовывается. Заполнение — это область внутри ограничивающего прямоугольника и влияет на макет любого дополнительного содержимого или дочерних объектов внутри элемента. FrameworkElement не определяет свойство заполнения, однако свойство определяется несколькими производными классами Padding . К ним относятся следующие объекты.

• Border.Padding
• Control.Padding
• TextBlock.Padding
• RichTextBlock.Padding
• ItemsPresenter.Padding

Дополнительные сведения о связи между полями и заполнением см. в разделах Выравнивание, поля и заполнение или Определение макетов с помощью XAML.

См. также раздел

• Thickness
• Выравнивание, поля и отбивка
• Определение макетов с помощью XAML