ImageField-Klasse

Einfaches Objekt, das einen Teil einer Form darstellt, die Decorator-Elemente oder Hintergründe der grafischen Darstellung kann.

Vererbungshierarchie

System.Object
  Microsoft.VisualStudio.Modeling.Diagrams.ShapeField
    Microsoft.VisualStudio.Modeling.Diagrams.ImageField

Namespace:  Microsoft.VisualStudio.Modeling.Diagrams
Assembly:  Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0 (in Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0.dll)

Syntax

'Declaration
Public Class ImageField _
    Inherits ShapeField

public class ImageField : ShapeField

Der ImageField-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	ImageField(String)	Initialisiert eine neue Instanz der ImageField-Klasse.
	ImageField(String, Image)	Initialisiert eine neue Instanz der ImageField-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	AnchoringBehavior	Beschreibt, wie der Inhalt des Felds und seine Größe selbst in Bezug auf das übergeordnete ShapeElement positioniert werden soll. (Von ShapeField geerbt.)
	DefaultAccessibleDescription	Ruft ab oder legt die barrierefreie Beschreibung fest. (Von ShapeField geerbt.)
	DefaultAccessibleName	Ruft den Text ab oder legt den Standardnamen des im Feld für das barrierefreie Objekt fest. (Von ShapeField geerbt.)
	DefaultAccessibleState	Ruft den Standardzustand des Felds Format für das barrierefreie Objekt, ab. (Von ShapeField geerbt.)
	DefaultBackgroundBrushId	Ruft die ID des standardmäßigen Pinsels ab, mit dem der Hintergrund des Felds Form zu zeichnen. (Von ShapeField geerbt.)
	DefaultFocusable	Ruft das Feld Form ab und überprüft, ob es den Fokus erhalten kann, oder gibt das Feld im die Möglichkeit, den Fokus zu empfangen. (Von ShapeField geerbt.)
	DefaultImage	Ruft das Symbol ab bzw. legt das Standardbild fest, das diesem ImageField zugeordnet ist.Das Standardbild kann angepasst werden, indem die GetDisplayImage-Methode überschreibt.
	DefaultInactiveSelectedBackgroundBrushId	Ruft ab oder legt die ID des Standardwert für das Feld im Hintergrund pinsels fest. (Von ShapeField geerbt.)
	DefaultPenId	Ruft die ID des standardmäßigen Stifts ab, die für das Feld Form zu verwenden. (Von ShapeField geerbt.)
	DefaultReflectParentFocusedState	Ruft das untergeordnete Formular ab und stellt sicher, dass im Feld es den Fokus erhalten soll, wenn ihre Elemente im Fokus erhält oder die Fähigkeit festlegt, der Fokuszustand des übergeordneten Formular zu entsprechen. (Von ShapeField geerbt.)
	DefaultReflectParentSelectedState	Ruft das untergeordnete Formular ab und stellt sicher, dass im Feld Auswahl dieser Option werden soll, wenn die übergeordnete Formular ausgewählt oder die Fähigkeit festlegt wird, den Auswahlzustand der übergeordneten Formular zu entsprechen. (Von ShapeField geerbt.)
	DefaultSelectable	Ruft das Feld Form ab und überprüft sie, ob standardmäßig ausgewählt werden kann, oder legt den Standardwert des Felds im ausgewählten Zustand fest. (Von ShapeField geerbt.)
	DefaultSelectedBackgroundBrushId	Ruft ab oder legt die ID des Standardwert für das Feld im Hintergrund pinsels fest. (Von ShapeField geerbt.)
	DefaultUnscaled	Ruft ab oder legt fest, ob das unskalierte Bild gezeichnetes sein soll, in Bezug auf die Grenzen dieses Felds oder Bild skaliert werden soll, die die angegebenen Begrenzungen passt.
	DefaultVisibility	Ruft das Feld Form ab und überprüft, ob er standardmäßig angezeigt oder die standardmäßige Sichtbarkeit des Felds im legt ihn fest. (Von ShapeField geerbt.)
	Name	Ruft den Namen des Felds im ab. (Von ShapeField geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AccessibleDoDefaultAction	Führt die Standardaktion für das Objekt, auf das zugegriffen werden kann, ausgegeben. (Von ShapeField geerbt.)
	AllowInPlaceEditorAutoSize	Aktiviert den direkten im Feld im Editor automatisch sortiert werden soll. (Von ShapeField geerbt.)
	AssociateValueWith(Store, AssociatedPropertyInfo)	Ordnet das Feld Form mit einer Domäneneigenschaft, die zu einem im Element zugewiesen ist. (Von ShapeField geerbt.)
	AssociateValueWith(Store, Guid)	Ordnet das Feld Form mit einer Domäneneigenschaft, die zu einem im Element zugewiesen ist. (Von ShapeField geerbt.)
	AssociateValueWith(Store, Guid, AssociatedPropertyInfo)	Ordnet das Feld Form mit einer Domäneneigenschaft, die zu einem im Element zugewiesen ist. (Von ShapeField geerbt.)
	AssociateVisibilityWith(Store, AssociatedPropertyInfo)	Ordnet die Sichtbarkeit des Felds Form mit einer Domäneneigenschaft, die zu einem im Element zugewiesen ist. (Von ShapeField geerbt.)
	AssociateVisibilityWith(Store, Guid)	Ordnet die Sichtbarkeit des Felds Form mit einer Domäneneigenschaft, die zu einem im Element zugewiesen ist. (Von ShapeField geerbt.)
	AssociateVisibilityWith(Store, Guid, AssociatedPropertyInfo)	Ordnet die Sichtbarkeit des Felds Form mit einer Domäneneigenschaft, die zu einem im Element zugewiesen ist. (Von ShapeField geerbt.)
	CanEditValue	Ruft das Feld Form ab und überprüft, ob er bearbeitet werden kann. (Von ShapeField geerbt.)
	CommitPendingEdit	Führt einen Commit für die anstehende Bearbeiten. (Von ShapeField geerbt.)
	DoHitTest	Führt einen Treffertest für einen angegebenen Punkt im Diagramm aus, um zu bestimmen, ob der Punkt innerhalb der angegebenen Begrenzungen des Felds im ist. (Von ShapeField geerbt.)
	DoKeyboardNavigation	Navigiert im Feld Form mithilfe der Tastatur. (Von ShapeField geerbt.)
	DoPaint	Zeichnet den Inhalt des ShapeField. (Überschreibt ShapeField.DoPaint(DiagramPaintEventArgs, ShapeElement).)
	EditValue(ShapeElement, DiagramClientView)	Öffnet den direkten Editor für das im Feld " Suchen " ein. (Von ShapeField geerbt.)
	EditValue(ShapeElement, DiagramClientView, PointD)	Öffnet den direkten Editor für das im Feld " Suchen " ein. (Von ShapeField geerbt.)
	Equals	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	FindFirstChild	Sucht das erste untergeordnete im Feld Feld auf dem übergeordneten Formular. (Von ShapeField geerbt.)
	FindLastChild	Sucht das letzte untergeordnete im Feld Feld auf dem übergeordneten Formular. (Von ShapeField geerbt.)
	FindNextChild	Sucht das nächste untergeordnete Elemente für das Feld im Feld Form. (Von ShapeField geerbt.)
	FindNextInChildSubFields	Sucht das nächste Feld untergeordnete Formular in der Navigationsreihenfolge. (Von ShapeField geerbt.)
	FindPreviousChild	Sucht das vorherige untergeordnete im Feld Feld auf dem übergeordneten Formular. (Von ShapeField geerbt.)
	FindPreviousInChildSubFields	Sucht das vorherige untergeordnete Formular in der Navigationsreihenfolge Feld. (Von ShapeField geerbt.)
	Focused	Ruft das Feld Form ab und überprüft, ob es den Fokus besitzt. (Von ShapeField geerbt.)
	GetAccessibilityObject	Ruft das Objekt für die Barrierefreiheit ab, das an das Feld im zugewiesen wird. (Von ShapeField geerbt.)
	GetAccessibleChild	Ruft das Objekt für die Barrierefreiheit für das untergeordnete Formular im Feld ab. (Von ShapeField geerbt.)
	GetAccessibleChildCount	Ruft die Anzahl der Objekte im Zusammenhang mit der Barrierefreiheit ab, die dem übergeordneten Formular und dessen untergeordneten im Feld Feldern zugewiesen werden. (Von ShapeField geerbt.)
	GetAccessibleDefaultActionDescription	Ruft den Zweck des Felds Format für das barrierefreie Objekt, ab. (Von ShapeField geerbt.)
	GetAccessibleDescription	Gibt die standardmäßige barrierefreie Beschreibung für ein Bild im Feld zurück. (Überschreibt ShapeField.GetAccessibleDescription(ShapeElement).)
	GetAccessibleHelp	Ruft die Hilfe für das Feld Form des barrierefreien Objekts ab, oder legt ihn fest. (Von ShapeField geerbt.)
	GetAccessibleHelpTopicFileName	Ruft ein Thema in der Hilfe für das barrierefreie Objekt, ab. (Von ShapeField geerbt.)
	GetAccessibleHelpTopicId	Ruft die ID ab, die dem Hilfethema zum barrierefreien Objekt zugeordnet ist, oder legt diesen fest. (Von ShapeField geerbt.)
	GetAccessibleName	Gibt den Standardwert für das Feld Name auf ein Bild zurück. (Überschreibt ShapeField.GetAccessibleName(ShapeElement).)
	GetAccessibleRole	Ruft die barrierefreie Rolle dieses ShapeField ab. (Überschreibt ShapeField.GetAccessibleRole(ShapeElement).)
	GetAccessibleState	Ruft den Zustand des Felds Form des barrierefreien Objekts ab, oder legt ihn fest. (Von ShapeField geerbt.)
	GetAccessibleValue	Ruft den Wert für das Feld Form für das barrierefreie Objekt, ab. (Von ShapeField geerbt.)
	GetActiveInPlaceEditor	Ruft den direkten Editor ab, der aktiv ist. (Von ShapeField geerbt.)
	GetBackgroundBrush	Ruft den Pinsel ab, der den Hintergrund für das im Element gezeichnet werden, für den dieses Feld Form zugewiesen wird. (Von ShapeField geerbt.)
	GetBackgroundBrushId	Ruft die ID des Pinsels ab, der den Hintergrund für das im Element gezeichnet werden, für den dieses Feld Form zugewiesen wird. (Von ShapeField geerbt.)
	GetBounds	Ruft die Grenzen für das Feld Form ab oder legt diese fest. (Von ShapeField geerbt.)
	GetCursor	Ruft den Zeiger ab, der angezeigt wird, wenn der Mauszeiger auf das Feld Form zeigt. (Von ShapeField geerbt.)
	GetDisplayImage	Ruft das von diesem Feld ab Bild, das angezeigt werden soll.
	GetFocusable	Ruft das Feld Form ab und überprüft, ob es den Fokus erhalten kann. (Von ShapeField geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetInPlaceEditorBounds	Ruft die Grenzen für den direkten Editor ab. (Von ShapeField geerbt.)
	GetMaximumInPlaceEditorSize	Ruft die maximalen Grenzen für den direkten Editor ab. (Von ShapeField geerbt.)
	GetMinimumInPlaceEditorSize	Ruft den kleinsten Grenzen für den direkten Editor ab. (Von ShapeField geerbt.)
	GetMinimumSize	Gibt die minimale Größe des ImageField zurück. (Überschreibt ShapeField.GetMinimumSize(ShapeElement).)
	GetPen	Ruft den Stift ab, der die Form " - Element gezeichnet wird, auf den das Feld Form zugewiesen wird. (Von ShapeField geerbt.)
	GetPenId	Ruft die ID des Stifts ab, der die Form " - Element gezeichnet wird, auf den das Feld Form zugewiesen wird. (Von ShapeField geerbt.)
	GetPotentialMouseAction	Ruft die Mausaktion ab, wann der Benutzer zu ermöglichen, als Nächstes auf einen bestimmten Punkt im Diagramm klickt. (Von ShapeField geerbt.)
	GetSelectable	Ruft das Feld Form ab und überprüft, ob er ausgewählt werden kann. (Von ShapeField geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	GetUnscaled	Ruft ab, ob das Bild gezeichnetes unskalierte sein sollen oder nicht.
	GetValue	Ruft den Wert für das Feld Form ab oder legt diese fest. (Von ShapeField geerbt.)
	GetValueDomainPropertyInfo	Ruft die Domäneneigenschaft ab, die dem Wert im Feld Form zugewiesen wird. (Von ShapeField geerbt.)
	GetVisible	Ruft das Feld Form ab und überprüft, ob er angezeigt wird. (Von ShapeField geerbt.)
	HasFocusedAppearance	Ruft das Formular ab und stellt sicher, dass im Feld angezeigt werden soll, es den Fokus besitzt. (Von ShapeField geerbt.)
	HasPendingEdit	Ruft das Formular ab und überprüft, ob das Feld als direkter Editor aktiv ist und eine Änderung aussteht. (Von ShapeField geerbt.)
	HasSelectedAppearance	Ruft das Feld Form ab und überprüft, ob er ausgewählt wird. (Von ShapeField geerbt.)
	IsNavigationKey(Char)	Ruft den Schlüssel ab, die vom Benutzer gedrückten und überprüft, ob sie verwendet werden kann, um zwischen Feldern Form zu navigieren. (Von ShapeField geerbt.)
	IsNavigationKey(Keys)	Ruft die vom Benutzer gedrückten Tasten, die abgerufen und überprüft, ob sie verwendet werden können, um zwischen Feldern Form zu navigieren. (Von ShapeField geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	NavigateAscend	Verschiebt den Fokus in das vorherige Feld Form in der Navigationsreihenfolge für die ausgewählten Formen. (Von ShapeField geerbt.)
	NavigateDescend	Verschiebt den Fokus auf das nächste Feld Form in der Navigationsreihenfolge für die ausgewählten Formen. (Von ShapeField geerbt.)
	NavigateToFirst	Verschiebt den Fokus auf das erste Feld Form in der Navigationsreihenfolge für die ausgewählten Formen. (Von ShapeField geerbt.)
	NavigateToLast	Verschiebt den Fokus auf das letzte Feld Form in der Navigationsreihenfolge für die ausgewählten Formen. (Von ShapeField geerbt.)
	NavigateToNext	Verschiebt den Fokus auf das nächste Feld Form in der Navigationsreihenfolge für die ausgewählten Formen. (Von ShapeField geerbt.)
	NavigateToPrevious	Verschiebt den Fokus in das vorherige Feld Form in der Navigationsreihenfolge für die ausgewählten Formen. (Von ShapeField geerbt.)
	OnBeginEdit	Alarmiert Listener, wenn die direkte Bearbeitung begonnen hat. (Von ShapeField geerbt.)
	OnClick	Alarmiert Listener, wenn der Benutzer auf ein Feld im geklickt hat. (Von ShapeField geerbt.)
	OnDoubleClick	Alarmiert Listener, wenn der Benutzer auf ein Feld im doppelgeklickt wurde. (Von ShapeField geerbt.)
	OnEndEdit	Alarmiert Listener, wenn die direkte Bearbeitung abgeschlossen wurde. (Von ShapeField geerbt.)
	OnKeyDown	Alarmiert Listener, wenn der Benutzer eine Taste gedrückt gehalten wird, hat bei einem zeigenden im Feld " Suchen " ein. (Von ShapeField geerbt.)
	OnKeyPress	Alarmiert Listener, wenn der Benutzer eine Taste gedrückt hat, wenn in einem Formular zeigt. (Von ShapeField geerbt.)
	OnKeyUp	Alarmiert Listener, wenn der Benutzer eine Taste losgelassen hat, wenn auf ein Feld im. (Von ShapeField geerbt.)
	OnMouseDown	Alarmiert Listener, wenn der Benutzer den Mauszeiger über ein Feld im gedrückt hält. (Von ShapeField geerbt.)
	OnMouseMove	Alarmiert Listener, wenn der Mauszeiger über ein Feld im verschoben wurde. (Von ShapeField geerbt.)
	OnMouseUp	Alarmiert Listener, wenn der Benutzer die Maustaste auf ein Feld im freigegeben hat. (Von ShapeField geerbt.)
	OnMouseWheel	Alarmiert Listener, wenn der Mauszeiger über ein Feld im gedreht wurde. (Von ShapeField geerbt.)
	Selected	Ruft das Feld Form ab und überprüft, ob er ausgewählt wird. (Von ShapeField geerbt.)
	SetSelectionRange	Legt die Auswahl in einem Bereich von Datenfeldern im untergeordneten fest. (Von ShapeField geerbt.)
	SetValue	Weist den angegebenen Wert in ein Format auf. (Von ShapeField geerbt.)
	SetVisible	Legt die Sichtbarkeit des Felds im fest. (Von ShapeField geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Hinweise

Wenn Sie ein Bild decorator-element in einem Formular definieren und Sie definieren eine Bild Form, der Bereich, in dem die Form angezeigt wird, durch ein ImageField verwaltet werden.Beispiele für die Initialisierung von ImageFields und anderen ShapeFields, überprüfen Sie Dsl GeneratedCode " \ \ Shapes.cs in der DSL-Projektmappe.

Ein ImageField ist ein Objekt, das einen Bereich in einem Formular verwaltet, wie der Fläche, das einem Decorator-Element zugewiesen wird.Eine ImageField-Instanz wird zwischen vielen Formen der gleichen Form Klasse freigegeben.Die ImageField-Instanz speichert kein separates Bild für jede Form: Stattdessen nimmt die Form der Methode GetDisplayImage(ShapeElement) als Parameter und kann von abhängigen das Bild des aktuellen Zustands der Form und des Modellelements gesucht wird.

Wenn Sie ein spezielles Verhalten wie ein variables Bild erstellen möchten, können Sie die Klasse verfügen, die von ImageField abgeleitet ist.

So erstellen Sie eine Unterklasse von ImageField

1. Legen Sie die Generiert abgeleitetes Double-Eigenschaft der übergeordneten Klasse in der Form DSL-Definition fest.

2. Überschreiben Sie die InitializeShapeFields-Methode der Form Klasse.

   • Erstellen Sie eine neue Codedatei im DSL-Projekt, und schreiben Sie eine partielle Klassendefinition für die Form Klasse.Überschreiben Sie die Methodendefinition ist.

3. Überprüfen Sie den Code aus InitializeShapeFields in DSL Shapes.cs GeneratedCode " \ \ ".

   In der Überschreibungsmethode müssen Sie die Basismethode auf, und erstellen Sie dann eine Instanz der Klasse im Feld Bild, besitzen.Verwenden Sie dies, um das normale Bild shapeFields Feld in der Liste ersetzt werden soll.

Beispiele

In diesem Beispiel wird ein Symbol Änderung abhängiges Element auf dem Zustand des Modellelements der Form.

Vorsicht

Dieses Beispiel zeigt, wie Sie ein Decorator-Element des dynamischen Bilds macht.Wenn Sie jedoch nur zwischen einem oder zwei Bilder abhängig vom Zustand einer Modell Variable wechseln möchten, ist es einfacher, mehrere Bild decorator-elemente zu erstellen, sucht sie in derselben Stelle auf das Formular, und legen Sie dann den Filter fest, um Sichtbarkeits von bestimmten Werten der Variablen Modell abzuhängen.Um diesen Filter festlegen, die im DSL-Definition in der zugeordnet DSL-Detail das ausgewählte Fenster öffnen, und auf die Decorator-Element-Registerkarte klicken.

Um den Beispielcode auszuführen, erstellen Sie eine neue DSL-Projektmappe mit minimalen Sprachen.Fügen Sie eine Domäneneigenschaft AlternateState des booleschen Werts der ExampleElement-Domänen - Klasse hinzu.Fügen Sie ein Symbol decorator-element der ExampleShape-Klasse hinzu, und legen Sie das Bild in eine Bitmapdatei fest.Klicken Sie auf Alle Vorlagen transformieren.Fügen Sie im DSL-Projekt eine neue Codedatei hinzu, und fügen Sie den folgenden Code ein.

Um den Code testen, und drücken Sie F5 in der Projektmappe, ein Diagramm. B. Debuggen öffnen.Der Standardzustand des Symbols angezeigt werden soll.Wählen Sie das Formular, und legen Sie im Eigenschaftenfenster den Wert der AlternateState-Eigenschaft ändern.Das Symbol sollte, um 90 Grad gedreht in dieser Form dann aussehen.

using Microsoft.VisualStudio.Modeling;
using Microsoft.VisualStudio.Modeling.Diagrams;
...
partial class ExampleShape
{
    /// <summary>
    /// Compose a list of the fields in this shape.
    /// Called once for each shape class.
    /// </summary>
    /// <param name="shapeFields"></param>
    protected override void InitializeShapeFields(IList<ShapeField> shapeFields)
    {
      // Fields set up according to DSL Definition:
      base.InitializeShapeFields(shapeFields);

      // Replace the image field:
      ShapeField oldField = ShapeElement.FindShapeField(shapeFields, "IconDecorator");
      shapeFields.Remove(oldField);
      // Must keep the same name:
      MyImageField newField = new MyImageField(oldField.Name);
      shapeFields.Add(newField);
      newField.DefaultImage = (oldField as ImageField).DefaultImage.Clone() as System.Drawing.Image;
    }
  }


  public class MyImageField : ImageField
  {
    public MyImageField(string tag) : base(tag) { }

    /// <summary>
    /// Get the image for this field in the given shape.
    /// </summary>
    public override System.Drawing.Image GetDisplayImage(ShapeElement parentShape)
    {
      ExampleElement element = parentShape.ModelElement as ExampleElement;
      if (element.AlternateState == true)
        return AlternateImage;
      else
        return base.GetDisplayImage(parentShape);
    }

    private System.Drawing.Image alternateImage;
    public System.Drawing.Image AlternateImage
    {
      get
      {
        if (alternateImage == null)
        {
          // Alternate image is a copy of the default, rotated by 90 degrees:
          alternateImage = this.DefaultImage.Clone() as System.Drawing.Image;
          alternateImage.RotateFlip(System.Drawing.RotateFlipType.Rotate90FlipNone);
        }
        return alternateImage;
      }
    }
  }
}

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.VisualStudio.Modeling.Diagrams-Namespace

TextField

ShapeField

InitializeShapeFields