DiagramTool
Esta classe de ferramenta abstrata é a classe base padrão para todas as ferramentas predefinidas.
Herda de: FrameworkElement
Implementa: IDiagramTool
Propriedades
public bool Active { get; set; }
value = diagramTool.Active
diagramTool.Active = value
Obtém ou define se esta ferramenta é iniciada e está fazendo algo ativamente.
public Diagram Diagram { get; set; }
value = diagramTool.Diagram
diagramTool.Diagram = value
Obtém o Diagrama que possui esta ferramenta e para o qual esta ferramenta está a lidar com os eventos de entrada.
public bool MouseEnabled { get; set; }
value = diagramTool.MouseEnabled
diagramTool.MouseEnabled = value
Obtém ou define se esta ferramenta pode ser iniciada por um evento do mouse.
protected string TransactionResult { get; set; }
value = diagramTool.TransactionResult
diagramTool.TransactionResult = value
Obtém ou define o nome da transação a ser cometida; se nulo, a transação será rebobinada.
public WheelBehavior WheelBehavior { get; set; }
value = diagramTool.WheelBehavior
diagramTool.WheelBehavior = value
Obtém ou define o comportamento de StandardMouseWheel.
Métodos
public virtual bool CanStart()
result = diagramTool.CanStart()
Este predicado é usado pelo diagrama para decidir se esta ferramenta pode ser iniciada.
Retorna: true se MouseEnabled for true e se o ToolManager pode fazer desta ferramenta a atual e então chamar o método DoStart@
protected virtual void CaptureMouse()
diagramTool.CaptureMouse()
Isto chama UIElement.CaptureMouse no Painel do Diagrama.
public virtual void DoActivate()
diagramTool.DoActivate()
Este método é chamado pelo diagrama após a configuração CurrentTool, para tornar a nova ferramenta ativa.
public virtual void DoCancel()
diagramTool.DoCancel()
O diagrama chamará este método quando o usuário desejar cancelar a operação da ferramenta atual.
public virtual void DoDeactivate()
diagramTool.DoDeactivate()
Este método é chamado pelo diagrama na ferramenta antiga quando CurrentTool é definido como uma nova ferramenta.
public virtual void DoKeyDown(KeyEventArgs e)
diagramTool.DoKeyDown(e)
O diagrama chamará este método sobre um evento chave para baixo.
public virtual void DoKeyUp(KeyEventArgs e)
diagramTool.DoKeyUp(e)
O diagrama chamará este método sobre um evento chave acima.
public virtual void DoMouseDown()
diagramTool.DoMouseDown()
O diagrama irá chamar este método sobre um evento do mouse para baixo.
public virtual void DoMouseMove()
diagramTool.DoMouseMove()
O diagrama chamará este método sobre um evento de movimento do mouse.
public virtual void DoMouseUp()
diagramTool.DoMouseUp()
O diagrama chamará este método sobre um evento do mouse acima.
public virtual void DoMouseWheel()
diagramTool.DoMouseWheel()
O diagrama chamará este método como a roda do mouse é girada.
public virtual void DoStart()
diagramTool.DoStart()
Este método é chamado pelo diagrama quando esta ferramenta se torna a ferramenta atual.
public virtual void DoStop()
diagramTool.DoStop()
Este método é chamado pelo diagrama quando esta ferramenta deixa de ser a ferramenta atual.
protected FrameworkElement FindAdornedElement(FrameworkElement handle)
result = diagramTool.FindAdornedElement(handle)
Dado um elemento de alça em um adorno, devolva seu adorno AdornedElement.
- handle
- a FrameworkElement
Retorna: a FrameworkElement dentro da parte adornada, não dentro deste adorno
protected Part FindAdornedPart(FrameworkElement handle)
result = diagramTool.FindAdornedPart(handle)
Dado um elemento de alça em um adorno, devolva seu adorno AdornedPart.
- handle
- a FrameworkElement
Retorna: uma parte que não é um adorno
protected Adornment FindAdornment(FrameworkElement handle)
result = diagramTool.FindAdornment(handle)
Dado um elemento de alça, devolva seu Adorno contendo.
- handle
- a FrameworkElement
Retorna: o Adorno contendo (que pode ser vários níveis visuais para cima) ou nulo se o elemento não pertence a um Adorno
protected virtual FrameworkElement FindElementUpFrom(FrameworkElement elt, Func<FrameworkElement, bool?> pred, Predicate<FrameworkElement> valid)
result = diagramTool.FindElementUpFrom(elt, pred, valid)
Pesquise a cadeia de elementos pais visuais começando com o elemento dado para encontrar um que tenha verdadeiro e verdadeiro.
- elt
- a FrameworkElement
- pred
- Quando este predicado é verdadeiro e são ambos verdadeiros, devolva esse elemento, Quando este predicado é falso, retorne nulo. Caso contrário, continue acima da cadeia pai. Pare de subir a cadeia pai visual ao chegar à Parte.
- valid
- um predicado que deve ser verdadeiro para um elemento para que ele seja devolvido por este método
protected virtual FrameworkElement FindElementUpFrom(FrameworkElement elt, Predicate<FrameworkElement> pred)
result = diagramTool.FindElementUpFrom(elt, pred)
Procurar a cadeia de elementos visuais pai começando com o elemento dado para encontrar um para o qual é verdadeiro
- elt
- a FrameworkElement
- pred
- Quando este predicado for verdadeiro para um elemento, devolva esse elemento. Quando este predicado for falso para um elemento, continue a cadeia de pai visual. Pare de subir a cadeia de pai visual ao chegar à Parte.
Retorna: null se não for encontrado tal elemento
protected virtual Part FindPartAt(Point p, bool selectable)
result = diagramTool.FindPartAt(p, selectable)
Encontre uma parte no ponto indicado, talvez exigindo que seja selecionável.
- p
- um ponto nas coordenadas do modelo
- selectable
- se for verdadeiro, a parte encontrada deverá ser selecionável; caso contrário, qualquer parte será suficiente
Retorna: a primeira (na primeira frente) Parte no local; a parte pode ser um nó ou um link, incluindo temporários como os Adornos.
protected virtual FrameworkElement FindToolHandleAt(Point p, string category)
result = diagramTool.FindToolHandleAt(p, category)
Encontre um elemento no ponto indicado que seja um punho de ferramenta.
- p
- um ponto nas coordenadas do modelo
- category
- Categoria do Adorno
protected virtual int GetWheelDelta()
result = diagramTool.GetWheelDelta()
Devolve o quanto a roda girou.
Retorna: Se o último evento do rato foi a roda do rato que se vira para a frente, isto devolve um inteiro positivo. Se o último evento do rato foi a roda do rato que se volta para trás, isto devolve um inteiro negativo. Caso contrário, este devolve zero.
protected virtual bool IsAltKeyDown()
result = diagramTool.IsAltKeyDown()
Devolver true quando o modificador de teclas alt for pressionado.
protected virtual bool IsBeyondDragSize()
result = diagramTool.IsBeyondDragSize()
Devolve true quando o último ponto do rato estiver suficientemente longe do primeiro ponto do rato para constituir uma operação de arrasto em vez de apenas um clique em potencial.
Retorna: true se o primeiro e último pontos do rato estiverem mais de dois pixels separados em ambos os eixos
protected virtual bool IsControlKeyDown()
result = diagramTool.IsControlKeyDown()
Devolver true quando o modificador de teclas de controlo for pressionado.
protected virtual bool IsDoubleClick()
result = diagramTool.IsDoubleClick()
Devolve true quando o último evento do mouse para baixo ocorreu muito perto e muito logo após o evento anterior do mouse para baixo.
protected virtual bool IsLeftButtonDown()
result = diagramTool.IsLeftButtonDown()
Devolver verdadeiro quando o botão esquerdo do rato for pressionado durante um evento do botão do rato.
protected virtual bool IsRightButtonDown()
result = diagramTool.IsRightButtonDown()
Devolver verdadeiro quando o botão direito do rato for pressionado durante um evento do botão do rato.
protected virtual bool IsShiftKeyDown()
result = diagramTool.IsShiftKeyDown()
Devolver true quando o modificador de teclas de mudança for pressionado.
protected bool RaiseEvent(RoutedEvent evt, DiagramEventArgs args)
result = diagramTool.RaiseEvent(evt, args)
Eleve um RoutedEvent no Diagrama.
- evt
- a RoutedEvent
- args
- a DiagramEventArgs
Retorna: verdadeiro se o evento foi levantado e foi Liderado
protected virtual void ReleaseMouse()
diagramTool.ReleaseMouse()
Isto chama UIElement.ReleaseMouseCapture no Painel do Diagrama.
protected virtual void StandardMouseSelect()
diagramTool.StandardMouseSelect()
Implemente o comportamento padrão para selecionar peças com o mouse, dependendo das teclas de controle e modificador de deslocamento.
protected virtual void StandardMouseWheel()
diagramTool.StandardMouseWheel()
Implemente o comportamento padrão para eventos de roda do mouse.
protected virtual bool StartTransaction(string tname)
result = diagramTool.StartTransaction(tname)
Chamar String) com o nome da transação.
- tname
public void StopTool()
diagramTool.StopTool()
Se o CurrentTool é esta ferramenta, pare esta ferramenta e inicie o DefaultTool@ fazendo com que seja a nova ferramenta atual.
protected virtual bool StopTransaction()
result = diagramTool.StopTransaction()
Se TransactionResult for null, chame RollbackTransaction, caso contrário chame String).
Retorna: o resultado da chamada para retroceder ou para comprometer a transação
public virtual void UpdateAdornments(Part part)
diagramTool.UpdateAdornments(part)
O diagrama pede a cada ferramenta que atualize qualquer adorno que a ferramenta possa usar para uma determinada parte.
- part
Campos
public static readonly DependencyProperty MouseEnabledProperty
value = DiagramTool.MouseEnabledProperty
Identifica a propriedade MouseEnabled dependência.
public static readonly DependencyProperty WheelBehaviorProperty
value = DiagramTool.WheelBehaviorProperty
Identifica a propriedade WheelBehavior.