DrawingAttributes Classe

Referência

Definição

Namespace:: System.Windows.Ink

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Especifica a aparência de um Stroke.

public ref class DrawingAttributes : System::ComponentModel::INotifyPropertyChanged

public class DrawingAttributes : System.ComponentModel.INotifyPropertyChanged

type DrawingAttributes = class
    interface INotifyPropertyChanged

Public Class DrawingAttributes
Implements INotifyPropertyChanged

Herança: Object
DrawingAttributes

Implementações: INotifyPropertyChanged

Exemplos

O exemplo a seguir demonstra como usar dois DrawingAttributes objetos para simular usando uma caneta e um marca-texto no mesmo InkCanvas. O exemplo pressupõe que o elemento raiz no arquivo XAML é um DockPanel chamado root. Ele também pressupõe que há um Button chamado switchHighlighter e que o Click evento está conectado ao manipulador de eventos definido neste exemplo.

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

Comentários

Use a DrawingAttributes propriedade para especificar configurações como cor, largura, transparência e a forma da dica de caneta para um Stroke.

Use a DefaultDrawingAttributes propriedade para especificar os atributos de desenho para os traços adicionados a um InkCanvas. Somente os traços adicionados após a DefaultDrawingAttributes alteração de passar mostram os atributos atualizados. A aparência dos traços que já estão no InkCanvas não muda.

Para obter uma lista de valores de propriedade iniciais para uma instância da DrawingAttributes classe , consulte o DrawingAttributes construtor .

Uso de texto XAML

Essa classe normalmente não é usada em XAML.

Construtores

DrawingAttributes()

Inicializa uma nova instância da classe DrawingAttributes.

Campos

MaxHeight	Especifica o maior valor permitido para a propriedade Height.
MaxWidth	Especifica o maior valor permitido para a propriedade Width.
MinHeight	Especifica o menor valor permitido para a propriedade Height.
MinWidth	Especifica o menor valor permitido para a propriedade Width.

Propriedades

Color	Obtém ou define a cor de um Stroke.
FitToCurve	Obtém ou define um valor que indica se a suavização de Bezier é usada para renderizar o Stroke.
Height	Obtém ou define a altura da caneta usada para desenhar o Stroke.
IgnorePressure	Obtém ou define um valor que indica se a espessura de um Stroke renderizado muda de acordo com a quantidade de pressão aplicada.
IsHighlighter	Obtém ou define um valor que indica se Stroke é semelhante a um marca-texto.
StylusTip	Obtém ou define a forma da caneta usada para desenhar o Stroke.
StylusTipTransform	Obtém ou define o Matrix que especifica a transformação a ser executada na ponta da caneta.
Width	Obtém ou define a largura da caneta usada para desenhar o Stroke.

Métodos

AddPropertyData(Guid, Object)	Adiciona uma propriedade personalizada ao objeto DrawingAttributes.
Clone()	Copia o objeto DrawingAttributes.
ContainsPropertyData(Guid)	Retorna um valor que indica se o identificador de dados da propriedade especificado está no objeto DrawingAttributes.
Equals(Object)	Determina se o objeto DrawingAttributes especificado é igual ao objeto DrawingAttributes atual.
GetHashCode()	Serve como uma função hash para um tipo particular.
GetPropertyData(Guid)	Obtém o valor da propriedade personalizada associada ao Guid especificado.
GetPropertyDataIds()	Retorna os GUIDs de todas as propriedades personalizadas associadas a StrokeCollection.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnAttributeChanged(PropertyDataChangedEventArgs)	Aciona o evento AttributeChanged.
OnPropertyChanged(PropertyChangedEventArgs)	Ocorre quando qualquer propriedade DrawingAttributes é alterada.
OnPropertyDataChanged(PropertyDataChangedEventArgs)	Aciona o evento PropertyDataChanged.
RemovePropertyData(Guid)	Remove a propriedade personalizada associada ao Guid especificado.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Operadores

Equality(DrawingAttributes, DrawingAttributes)	Determina se os objetos DrawingAttributes especificados são iguais.
Inequality(DrawingAttributes, DrawingAttributes)	Determina se os objetos DrawingAttributes especificados não são iguais.

Eventos

AttributeChanged	Ocorre quando uma propriedade no objeto DrawingAttributes é alterada.
PropertyDataChanged	Ocorre quando os dados da propriedade são adicionados ou removidos da StrokeCollection.

Implantações explícitas de interface

INotifyPropertyChanged.PropertyChanged

Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código.

Ocorre quando o valor de qualquer propriedade DrawingAttributes foi alterado.

Aplica-se a

Partilhar via