Block.Margin Свойство

Определение

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

System.Windows.Documents

Сборка:

PresentationFramework.dll

Получает или задает толщину поля для элемента.

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

public System.Windows.Thickness Margin { get; set; }

member this.Margin : System.Windows.Thickness with get, set

Public Property Margin As Thickness

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

Thickness

Структура Thickness, которая указывает применяемое значение поля в аппаратно-независимых пикселях. Значение по умолчанию — единая нулевая толщина (0,0).

Примеры

В следующем примере показано, как задать Margin атрибут Block элемента (Paragraph).

<FlowDocument Background="LightSlateGray" ColumnWidth="2000">
  <Section Background="DarkMagenta" Margin="0" Padding="0">
    <Paragraph Background="White">
      <Run>Default paragraph.</Run>
    </Paragraph>
    <Paragraph Background="White">
      <Run>Default paragraph.</Run>
    </Paragraph>
    <Paragraph Background="LightBlue" Margin="50">
      <Run>This paragraph has a magin of 50 pixels set, but no padding.</Run>
    </Paragraph>
    <Paragraph Background="LightCoral" Padding="50">
      <Run>This paragraph has padding of 50 pixels set, but no margin.</Run>
    </Paragraph>
    <Paragraph Background="LightGreen" Margin="50" Padding="50">
      <Run>This paragraph has both padding and margin set to 50 pixels.</Run>
    </Paragraph>
    <Paragraph Background="White">
      <Run>Default paragraph.</Run>
    </Paragraph>
    <Paragraph Background="White">
      <Run>Default paragraph.</Run>
    </Paragraph>
  </Section>
</FlowDocument>

На следующем рисунке показано, как выполняется отрисовка предыдущего примера. Для иллюстрации используются преувеличенные толщины и цвета.

В следующем примере показано, как задать Margin свойство программным способом.

FlowDocument flowDoc = new FlowDocument();
Section sec = new Section();

flowDoc.Background = Brushes.LightSlateGray;
flowDoc.ColumnWidth = 2000;
sec.Background = Brushes.DarkMagenta;
sec.Padding = sec.Margin = new Thickness(0);

Paragraph defPar1 = new Paragraph(new Run("Default paragraph."));
Paragraph defPar2 = new Paragraph(new Run("Default paragraph."));
Paragraph defPar3 = new Paragraph(new Run("Default paragraph."));
Paragraph defPar4 = new Paragraph(new Run("Default paragraph."));
defPar1.Background = defPar2.Background = defPar3.Background = defPar4.Background = Brushes.White;

Paragraph marginPar = new Paragraph(new Run("This paragraph has a magin of 50 pixels set, but no padding."));
marginPar.Background = Brushes.LightBlue;
marginPar.Margin = new Thickness(50);
Paragraph paddingPar = new Paragraph(new Run("This paragraph has padding of 50 pixels set, but no margin."));
paddingPar.Background = Brushes.LightCoral;
paddingPar.Padding = new Thickness(50);
Paragraph marginPaddingPar = new Paragraph(new Run("This paragraph has both padding and margin set to 50 pixels."));
marginPaddingPar.Background = Brushes.LightGreen;
marginPaddingPar.Padding = marginPaddingPar.Margin = new Thickness(50);

sec.Blocks.Add(defPar1);
sec.Blocks.Add(defPar2);
sec.Blocks.Add(marginPar);
sec.Blocks.Add(paddingPar);
sec.Blocks.Add(marginPaddingPar);
sec.Blocks.Add(defPar3);
sec.Blocks.Add(defPar4);
flowDoc.Blocks.Add(sec);

Dim flowDoc As New FlowDocument()
Dim sec As New Section()

flowDoc.Background = Brushes.LightSlateGray
flowDoc.ColumnWidth = 2000
sec.Background = Brushes.DarkMagenta
sec.Margin = New Thickness(0)
sec.Padding = sec.Margin

Dim defPar1 As New Paragraph(New Run("Default paragraph."))
Dim defPar2 As New Paragraph(New Run("Default paragraph."))
Dim defPar3 As New Paragraph(New Run("Default paragraph."))
Dim defPar4 As New Paragraph(New Run("Default paragraph."))
defPar4.Background = Brushes.White
defPar3.Background = defPar4.Background
defPar2.Background = defPar3.Background
defPar1.Background = defPar2.Background

Dim marginPar As New Paragraph(New Run("This paragraph has a magin of 50 pixels set, but no padding."))
marginPar.Background = Brushes.LightBlue
marginPar.Margin = New Thickness(50)
Dim paddingPar As New Paragraph(New Run("This paragraph has padding of 50 pixels set, but no margin."))
paddingPar.Background = Brushes.LightCoral
paddingPar.Padding = New Thickness(50)
Dim marginPaddingPar As New Paragraph(New Run("This paragraph has both padding and margin set to 50 pixels."))
With marginPaddingPar
    .Background = Brushes.LightGreen
    .Margin = New Thickness(50)
    .Padding = marginPaddingPar.Margin
End With

sec.Blocks.Add(defPar1)
sec.Blocks.Add(defPar2)
sec.Blocks.Add(marginPar)
sec.Blocks.Add(paddingPar)
sec.Blocks.Add(marginPaddingPar)
sec.Blocks.Add(defPar3)
sec.Blocks.Add(defPar4)
flowDoc.Blocks.Add(sec)

Комментарии

Margin — это буферное пространство, которое выходит за пределы области содержимого элемента между краями области содержимого элемента и краями родительского элемента. Контрастирует с Paddingпространством буфера, которое попадает в область содержимого элемента между содержимым элемента и внутренним краем элемента.

Использование атрибута XAML

<object Margin="uniformThickness"/>  
- or -  
<object Margin="independentThickness"/>  
- or -  
<object Margin="qualifiedUniformThickness"/>  
- or -  
<object Margin="qualifiedIndependentThickness"/>  

Значения XAML

uniformThickness
Строковое представление одного Double значения, которое применяется равномерно ко всем четырем измерениям толщины. Например, значение "10" эквивалентно значению "10,10,10,10". Неквалифицированное значение измеряется в независимых пикселях устройства. Строки не должны явно включать десятичные знаки.

independentThickness
Строковое представление четырех упорядоченных Double значений, соответствующих независимым измерениям толщины для левого, верхнего, правого и нижнего значений в этом порядке. Четыре значения должны быть разделены запятыми; пробелы не допускаются. Например, "5,10,15,20" приводит к 5 пикселям поля слева от содержимого, 10 пикселей поля над содержимым, 15 пикселей поля справа от содержимого и 20 пикселей поля под содержимым.

qualifiedUniformThickness
Значение, описанное однородным описателями, за которым следует один из следующих описателей единиц: px, in.

px (по умолчанию) — это не зависящие от устройства единицы измерения (1/96-й дюйм на единицу)

in имеет дюймы; 1in===96 пикселей

Например, "1in" обеспечивает равномерное поле на 1 дюйм во всех направлениях.

qualifiedIndependentThickness
Значение, описываемое независимым значением, с каждым независимым значением, за которым следует один из следующих описателей единиц: px, in.

px (по умолчанию) — это не зависящие от устройства единицы измерения (1/96-й дюйм на единицу)

in имеет дюймы; 1in===96 пикселей

Например, "1.5in,0.8in,1.5in,0.8in". Описатели единиц могут быть смешанными или опущены из одного или нескольких значений.

Сведения о свойстве зависимостей

Поле идентификатора	MarginProperty
Для свойств метаданных задано значение true	AffectsMeasure

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

• Padding