DrawingAttributes Класс

Определение

Определяет внешний вид StrokeSpecifies the appearance of a Stroke

public ref class DrawingAttributes : System::ComponentModel::INotifyPropertyChanged
public class DrawingAttributes : System.ComponentModel.INotifyPropertyChanged
type DrawingAttributes = class
    interface INotifyPropertyChanged
Public Class DrawingAttributes
Implements INotifyPropertyChanged
Наследование
DrawingAttributes
Реализации

Примеры

В следующем примере показано, как использовать два DrawingAttributes объекта для имитации с помощью пера и выделения в одном и том InkCanvasже.The following example demonstrates how to use two DrawingAttributes objects to simulate using a pen and a highlighter on the same InkCanvas. В примере предполагается, что корневой элемент в файле DockPanel XAML называется. rootThe example assumes the root element in the XAML file is a DockPanel called root. Также предполагается, что имеется Button вызванный switchHighlighter и что Click событие подключено к обработчику событий, определенному в этом примере.It also assumes that there is a Button called switchHighlighter and that the Click event is connected to the event handler defined in this example.

InkCanvas inkCanvas1 = new InkCanvas();
DrawingAttributes inkDA;
DrawingAttributes highlighterDA;
bool useHighlighter = false;

// Add an InkCanvas to the window, and allow the user to 
// switch between using a green pen and a purple highlighter 
// on the InkCanvas.
private void WindowLoaded(object sender, EventArgs e)
{
    inkCanvas1.Background = Brushes.DarkSlateBlue;
    inkCanvas1.DefaultDrawingAttributes.Color = Colors.SpringGreen;

    root.Children.Add(inkCanvas1);

    // Set up the DrawingAttributes for the pen.
    inkDA = new DrawingAttributes();
    inkDA.Color = Colors.SpringGreen;
    inkDA.Height = 5;
    inkDA.Width = 5;
    inkDA.FitToCurve = false;

    // Set up the DrawingAttributes for the highlighter.
    highlighterDA = new DrawingAttributes();
    highlighterDA.Color = Colors.Orchid;
    highlighterDA.IsHighlighter = true;
    highlighterDA.IgnorePressure = true;
    highlighterDA.StylusTip = StylusTip.Rectangle;
    highlighterDA.Height = 30;
    highlighterDA.Width = 10;

    inkCanvas1.DefaultDrawingAttributes = inkDA;
}

// Create a button called switchHighlighter and use 
// SwitchHighlighter_Click to handle the Click event.  
// The useHighlighter variable is a boolean that indicates
// whether the InkCanvas renders ink as a highlighter.

// Switch between using the 'pen' DrawingAttributes and the 
// 'highlighter' DrawingAttributes.
void SwitchHighlighter_Click(Object sender, RoutedEventArgs e)
{
    useHighlighter = !useHighlighter;
    
    if (useHighlighter)
    {
        switchHighlighter.Content = "Use Pen";
        inkCanvas1.DefaultDrawingAttributes = highlighterDA;
    }
    else
    {
        switchHighlighter.Content = "Use Highlighter";
        inkCanvas1.DefaultDrawingAttributes = inkDA;

    }
}

Private WithEvents inkCanvas1 As New InkCanvas()
Private inkDA As DrawingAttributes
Private highlighterDA As DrawingAttributes
Private useHighlighter As Boolean = False

' Add an InkCanvas to the window, and allow the user to 
' switch between using a green pen and a purple highlighter 
' on the InkCanvas.
Private Sub WindowLoaded(ByVal sender As Object, ByVal e As RoutedEventArgs)

    inkCanvas1.Background = Brushes.DarkSlateBlue
    inkCanvas1.DefaultDrawingAttributes.Color = Colors.SpringGreen

    ' Add the InkCanvas to the DockPanel, named root.
    root.Children.Add(inkCanvas1)

    ' Set up the DrawingAttributes for the pen.
    inkDA = New DrawingAttributes()
    With inkDA
        .Color = Colors.SpringGreen
        .Height = 5
        .Width = 5
        .FitToCurve = True
    End With

    ' Set up the DrawingAttributes for the highlighter.
    highlighterDA = New DrawingAttributes()
    With highlighterDA
        .Color = Colors.Orchid
        .IsHighlighter = True
        .IgnorePressure = True
        .StylusTip = StylusTip.Rectangle
        .Height = 30
        .Width = 10
    End With

    inkCanvas1.DefaultDrawingAttributes = inkDA

End Sub


' Create a button called switchHighlighter and use 
' SwitchHighlighter_Click to handle the Click event.  
' The useHighlighter variable is a boolean that indicates
' whether the InkCanvas renders ink as a highlighter.

' Switch between using the 'pen' DrawingAttributes and the 
' 'highlighter' DrawingAttributes when the user clicks on .
Private Sub SwitchHighlighter_Click(ByVal sender As [Object], ByVal e As RoutedEventArgs)

    useHighlighter = Not useHighlighter

    If useHighlighter Then
        switchHighlighter.Content = "Use Pen"
        inkCanvas1.DefaultDrawingAttributes = highlighterDA
    Else

        switchHighlighter.Content = "Use Highlighter"
        inkCanvas1.DefaultDrawingAttributes = inkDA
    End If

End Sub

Комментарии

Используйте свойство, чтобы задать такие параметры, как цвет, ширина, прозрачность и форма кончика пера Strokeдля. DrawingAttributesUse the DrawingAttributes property to specify settings such as color, width, transparency, and the shape of the stylus tip for a Stroke.

Используйте свойство, чтобы указать атрибуты рисования для штрихов, добавляемых InkCanvasв. DefaultDrawingAttributesUse the DefaultDrawingAttributes property to specify the drawing attributes for the strokes added to an InkCanvas. Обновленные атрибуты отображаются только в штрихах DefaultDrawingAttributes , которые добавляются после изменения.Only strokes that are added after the DefaultDrawingAttributes undergo change show the updated attributes. Внешний вид штрихов, которые уже находятся в, InkCanvas не меняются.The appearance of the strokes that are already on the InkCanvas does not change.

Список начальных значений свойств для экземпляра класса DrawingAttributes см. в описании конструктора DrawingAttributes.For a list of initial property values for an instance of the DrawingAttributes class, see the DrawingAttributes constructor.

Использование текста XAMLXAML Text Usage

Этот класс обычно не используется в XAML.This class is not typically used in XAML.

Конструкторы

DrawingAttributes()

Инициализирует новый экземпляр класса DrawingAttributes.Initializes a new instance of the DrawingAttributes class.

Поля

MaxHeight

Задает наибольшее значение, допустимое для свойства Height.Specifies the largest value allowed for the Height property.

MaxWidth

Задает наибольшее значение, допустимое для свойства Width.Specifies the largest value allowed for the Width property.

MinHeight

Задает наименьшее значение, допустимое для свойства Height.Specifies the smallest value allowed for the Height property.

MinWidth

Задает наименьшее значение, допустимое для свойства Width.Specifies the smallest value allowed for the Width property.

Свойства

Color

Получает или задает цвет Stroke.Gets or sets the color of a Stroke.

FitToCurve

Получает или задает значение, определяющее, используется ли сглаживание Безье при отрисовке Stroke.Gets or sets a value that indicates whether Bezier smoothing is used to render the Stroke.

Height

Получает или задает высоту пера, используемого при отрисовке Stroke.Gets or sets the height of the stylus used to draw the Stroke.

IgnorePressure

Получает или задает значение, определяющее, будет ли толщина отрисованного Stroke изменяться в соответствии с силой нажатия на перо.Gets or sets a value that indicates whether the thickness of a rendered Stroke changes according the amount of pressure applied.

IsHighlighter

Получает или задает значение, указывающее, выглядит ли Stroke подобно маркеру.Gets or sets a value that indicates whether the Stroke looks like a highlighter.

StylusTip

Получает или задает форму пера, используемого при отрисовке Stroke.Gets or sets the shape of the stylus used to draw the Stroke.

StylusTipTransform

Получает или задает значение Matrix, определяющее преобразование, применяемое к кончику пера.Gets or sets the Matrix that specifies the transformation to perform on the stylus' tip.

Width

Получает или задает ширину пера, используемого при отрисовке Stroke.Gets or sets the width of the stylus used to draw the Stroke.

Методы

AddPropertyData(Guid, Object)

Добавляет пользовательское свойство к объекту DrawingAttributes.Adds a custom property to the DrawingAttributes object.

Clone()

Копирует объект DrawingAttributes.Copies the DrawingAttributes object.

ContainsPropertyData(Guid)

Возвращает значение, указывающее, находится ли указанный идентификатор данных свойств в объекте DrawingAttributes.Returns a value that indicates whether the specified property data identifier is in the DrawingAttributes object.

Equals(Object)

Определяет, равен ли заданный объект DrawingAttributes текущему объекту DrawingAttributes.Determines whether the specified DrawingAttributes object is equal to the current DrawingAttributes object.

GetHashCode()

Служит хэш-функцией для определенного типа.Serves as a hash function for a particular type.

GetPropertyData(Guid)

Возвращает значение пользовательского свойства, связанного с указанным Guid.Gets the value of the custom property associated with the specified Guid.

GetPropertyDataIds()

Возвращает идентификаторы GUID всех пользовательских свойств, связанных с StrokeCollection.Returns the GUIDs of any custom properties associated with the StrokeCollection.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnAttributeChanged(PropertyDataChangedEventArgs)

Вызывает событие AttributeChanged.Raises the AttributeChanged event.

OnPropertyChanged(PropertyChangedEventArgs)

Происходит при изменении любого свойства DrawingAttributes.Occurs when any DrawingAttributes property changes.

OnPropertyDataChanged(PropertyDataChangedEventArgs)

Вызывает событие PropertyDataChanged.Raises the PropertyDataChanged event.

RemovePropertyData(Guid)

Удаляет пользовательское свойство, связанное с указанным Guid.Removes the custom property associated with the specified Guid.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Операторы

Equality(DrawingAttributes, DrawingAttributes)

Определяет, равны ли указанные объекты DrawingAttributes.Determines whether the specified DrawingAttributes objects are equal.

Inequality(DrawingAttributes, DrawingAttributes)

Определяет, различаются ли указанные объекты DrawingAttributes.Determines whether the specified DrawingAttributes objects are not equal.

События

AttributeChanged

Происходит при изменении свойства объекта DrawingAttributes.Occurs when a property in the DrawingAttributes object changes.

PropertyDataChanged

Происходит при добавлении или удалении данных свойств из StrokeCollection.Occurs when property data is added or removed from the StrokeCollection.

Явные реализации интерфейса

INotifyPropertyChanged.PropertyChanged

Происходит при изменении значения любого свойства DrawingAttributes.Occurs when the value of any DrawingAttributes property has changed.

Применяется к