ImageField – třída

Lehký objekt, který představuje část obrazce, které lze zobrazit obraz sklenářské nebo pozadí.

Hierarchie dědičnosti

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

Obor názvů:  Microsoft.VisualStudio.Modeling.Diagrams
Sestavení:  Microsoft.VisualStudio.Modeling.Sdk.Diagrams.12.0 (v Microsoft.VisualStudio.Modeling.Sdk.Diagrams.12.0.dll)

Syntaxe

'Deklarace
Public Class ImageField _
    Inherits ShapeField

public class ImageField : ShapeField

Typ ImageField zveřejňuje následující členy.

Konstruktory

	Název	Popis
	ImageField(String)	Inicializuje novou instanci třídy ImageField.
	ImageField(String, Image)	Inicializuje novou instanci třídy ImageField.

Nahoru

Vlastnosti

	Název	Popis
	AnchoringBehavior	Popisuje, jak by obsah pole umístění a velikost samotného v nadřazené ShapeElement. (Zděděno z ShapeField.)
	DefaultAccessibleDescription	Získá nebo nastaví výchozí popis přístupné. (Zděděno z ShapeField.)
	DefaultAccessibleName	Získá nebo nastaví výchozí název pole obrazce pro přístupný objekt. (Zděděno z ShapeField.)
	DefaultAccessibleState	Načte výchozí stav pole obrazce pro přístupný objekt. (Zděděno z ShapeField.)
	DefaultBackgroundBrushId	Získá nebo nastaví ID výchozí štětec k malování na pozadí pole obrazce. (Zděděno z ShapeField.)
	DefaultFocusable	Načte pole obrazce a ověří, zda lze aktivovat nebo umožňuje pole obrazec vybrán. (Zděděno z ShapeField.)
	DefaultImage	Získá nebo nastaví výchozí obrázek přidružený k této třídy ImageField.Potlačení metody GetDisplayImage mohou přizpůsobit výchozí obrázek.
	DefaultInactiveSelectedBackgroundBrushId	Získá nebo nastaví ID stopy výchozího pozadí pro pole obrazce. (Zděděno z ShapeField.)
	DefaultPenId	Získá nebo nastaví ID pera výchozí tvar pole. (Zděděno z ShapeField.)
	DefaultReflectParentFocusedState	Získá podřízené obrazce pole a ověří, zda ji měli aktivovat při jeho nadřazený obrazec vybrán nebo nastaví schopnost odrážet stav zaměření jeho nadřazeného obrazce. (Zděděno z ShapeField.)
	DefaultReflectParentSelectedState	Získá podřízené obrazce pole a ověří, zda ji musí být vybrána při jeho nadřazeného obrazce výběru nebo nastaví schopnost odrážet stavu výběru jeho nadřazeného obrazce. (Zděděno z ShapeField.)
	DefaultSelectable	Získá pole obrazce a ověří, zda lze vybrat výchozí nebo nastaví výchozí stav výběru pole obrazce. (Zděděno z ShapeField.)
	DefaultSelectedBackgroundBrushId	Získá nebo nastaví ID stopy výchozího pozadí pro pole obrazce. (Zděděno z ShapeField.)
	DefaultUnscaled	Získá nebo nastaví, zda je obrázek by měl být stanoven s ohledem na hranice tohoto pole bez měřítka nebo měřítka obrázku přizpůsobit hranice.
	DefaultVisibility	Načte pole obrazce a ověří, zda se standardně zobrazí nebo nastaví výchozí viditelnost pole obrazce. (Zděděno z ShapeField.)
	Name	Získá název pole obrazce. (Zděděno z ShapeField.)

Nahoru

Metody

	Název	Popis
	AccessibleDoDefaultAction	Provede výchozí akce pro přístupný objekt. (Zděděno z ShapeField.)
	AllowInPlaceEditorAutoSize	Umožňuje místní editor se automaticky do pole obrazec velikosti. (Zděděno z ShapeField.)
	AssociateValueWith(Store, AssociatedPropertyInfo)	Vlastnost domény přiřazené k prvku tvar přidruží pole obrazce. (Zděděno z ShapeField.)
	AssociateValueWith(Store, Guid)	Vlastnost domény přiřazené k prvku tvar přidruží pole obrazce. (Zděděno z ShapeField.)
	AssociateValueWith(Store, Guid, AssociatedPropertyInfo)	Vlastnost domény přiřazené k prvku tvar přidruží pole obrazce. (Zděděno z ShapeField.)
	AssociateVisibilityWith(Store, AssociatedPropertyInfo)	Vlastnost domény přiřazené k prvku tvar přidruží viditelnost pole obrazce. (Zděděno z ShapeField.)
	AssociateVisibilityWith(Store, Guid)	Vlastnost domény přiřazené k prvku tvar přidruží viditelnost pole obrazce. (Zděděno z ShapeField.)
	AssociateVisibilityWith(Store, Guid, AssociatedPropertyInfo)	Vlastnost domény přiřazené k prvku tvar přidruží viditelnost pole obrazce. (Zděděno z ShapeField.)
	CanEditValue	Získá pole obrazce a ověří, zda mohou být upravovány. (Zděděno z ShapeField.)
	CommitPendingEdit	Úpravy čeká na potvrzení. (Zděděno z ShapeField.)
	DoHitTest	Zadaný bod v diagramu zjistit, zda je v poli obrazec hranice provádí test zásahu. (Zděděno z ShapeField.)
	DoKeyboardNavigation	Přejde do pole obrazec pomocí klávesnice. (Zděděno z ShapeField.)
	DoPaint	Kreslí obsah ShapeField. (Přepisuje ShapeField.DoPaint(DiagramPaintEventArgs, ShapeElement).)
	EditValue(ShapeElement, DiagramClientView)	Otevře editor pro pole obrazce v místě. (Zděděno z ShapeField.)
	EditValue(ShapeElement, DiagramClientView, PointD)	Otevře editor pro pole obrazce v místě. (Zděděno z ShapeField.)
	Equals	Určuje, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno z Object.)
	Finalize	Umožňuje objektu k pokusu uvolnit prostředky a provádět další operace vyčištění před je zažádáno systémem uvolňování paměti. (Zděděno z Object.)
	FindFirstChild	Do pole nadřazený obrazec vyhledá první pole podřízený obrazec. (Zděděno z ShapeField.)
	FindLastChild	Do pole nadřazený obrazec vyhledá pole poslední podřízené obrazce. (Zděděno z ShapeField.)
	FindNextChild	Vyhledá další podřízené obrazce pole do pole nadřazený obrazec. (Zděděno z ShapeField.)
	FindNextInChildSubFields	Vyhledá pole další podřízené obrazce v pořadí navigace. (Zděděno z ShapeField.)
	FindPreviousChild	Do pole nadřazený obrazec vyhledá předchozí pole podřízený obrazec. (Zděděno z ShapeField.)
	FindPreviousInChildSubFields	Vyhledá předchozí pole podřízené obrazce v pořadí navigace. (Zděděno z ShapeField.)
	Focused	Načte pole obrazce a ověří, zda má fokus. (Zděděno z ShapeField.)
	GetAccessibilityObject	Získá usnadnění objekt, který je přiřazen do pole obrazce. (Zděděno z ShapeField.)
	GetAccessibleChild	Získá objekt usnadnění pro pole podřízené obrazce. (Zděděno z ShapeField.)
	GetAccessibleChildCount	Počet objektů usnadnění, které jsou přiřazeny obrazce nadřízeného pole a pole jeho podřízené obrazce získá. (Zděděno z ShapeField.)
	GetAccessibleDefaultActionDescription	Načte výchozí účel pole obrazce pro přístupný objekt. (Zděděno z ShapeField.)
	GetAccessibleDescription	Vrací výchozí popis přístupné pro obrazové pole. (Přepisuje ShapeField.GetAccessibleDescription(ShapeElement).)
	GetAccessibleHelp	Získá tvar pole Nápověda pro přístupný objekt. (Zděděno z ShapeField.)
	GetAccessibleHelpTopicFileName	Získá téma v nápovědě pro přístupný objekt. (Zděděno z ShapeField.)
	GetAccessibleHelpTopicId	Načte ID, který je přiřazen k tématu nápovědy pro přístupný objekt. (Zděděno z ShapeField.)
	GetAccessibleName	Vrátí název výchozí přístupné pro obrazové pole. (Přepisuje ShapeField.GetAccessibleName(ShapeElement).)
	GetAccessibleRole	Načte přístupné role tohoto ShapeField. (Přepisuje ShapeField.GetAccessibleRole(ShapeElement).)
	GetAccessibleState	Získá stav pole obrazce pro přístupný objekt. (Zděděno z ShapeField.)
	GetAccessibleValue	Získá hodnotu do pole obrazec pro přístupný objekt. (Zděděno z ShapeField.)
	GetActiveInPlaceEditor	Získá přímo v editoru, který je aktivní. (Zděděno z ShapeField.)
	GetBackgroundBrush	Stopy, které nakreslí pozadí tvar prvku tohoto pole tvar přiřazenou získá. (Zděděno z ShapeField.)
	GetBackgroundBrushId	Načte ID stopy, které nakreslí pozadí tvar prvku tohoto pole tvar přiřazenou. (Zděděno z ShapeField.)
	GetBounds	Získá hranice pro pole obrazce. (Zděděno z ShapeField.)
	GetCursor	Získá ukazatel, který se zobrazí v případě, že pole obrazec umístěn ukazatel myši. (Zděděno z ShapeField.)
	GetDisplayImage	Načte obrázek zobrazit v tomto poli.
	GetFocusable	Načte pole obrazce a ověří, zda ji lze aktivovat. (Zděděno z ShapeField.)
	GetHashCode	Slouží jako výchozí funkce hash. (Zděděno z Object.)
	GetInPlaceEditorBounds	Získá hranice pro editor v místě. (Zděděno z ShapeField.)
	GetMaximumInPlaceEditorSize	Získá maximální hranice pro editor v místě. (Zděděno z ShapeField.)
	GetMinimumInPlaceEditorSize	Získá minimální hranice pro editor v místě. (Zděděno z ShapeField.)
	GetMinimumSize	Minimální velikost ImageField vrátí. (Přepisuje ShapeField.GetMinimumSize(ShapeElement).)
	GetPen	Získá pero kreslí tvar prvku pole obrazce přiřazenou. (Zděděno z ShapeField.)
	GetPenId	Načte ID pero kreslí tvar prvku pole obrazce přiřazenou. (Zděděno z ShapeField.)
	GetPotentialMouseAction	Získá akce myši aktivovat při dalším klepnutí určitý bod v diagramu. (Zděděno z ShapeField.)
	GetSelectable	Načte pole obrazce a ověří, zda může být vybrána. (Zděděno z ShapeField.)
	GetType	Získá Type aktuální instance. (Zděděno z Object.)
	GetUnscaled	Získá zda obrazu vyvodit bez měřítka nebo ne.
	GetValue	Načte hodnotu do pole obrazec. (Zděděno z ShapeField.)
	GetValueDomainPropertyInfo	Získá vlastnosti domény, která je přiřazena hodnota v poli tvar. (Zděděno z ShapeField.)
	GetVisible	Načte pole obrazce a ověří, zda se zobrazí. (Zděděno z ShapeField.)
	HasFocusedAppearance	Načte pole obrazce a ověří, zda by se fokus. (Zděděno z ShapeField.)
	HasPendingEdit	Získá pole obrazce a kontroluje jeho přímo v editoru je aktivní a změna čeká na vyřízení. (Zděděno z ShapeField.)
	HasSelectedAppearance	Načte pole obrazce a ověří, zda se zdá být vybrán. (Zděděno z ShapeField.)
	IsNavigationKey(Char)	Získá klíč, který uživatel stisknutí a ověří, zda jej lze procházet mezi obrazci. (Zděděno z ShapeField.)
	IsNavigationKey(Keys)	Získá klíčů, které uživatel stisknutí a ověří, zda jsou lze procházet mezi obrazci. (Zděděno z ShapeField.)
	MemberwiseClone	Vytvoří mělká kopie aktuálního Object. (Zděděno z Object.)
	NavigateAscend	Přejde na předchozí pole tvaru v pořadí navigace pro vybrané obrazce. (Zděděno z ShapeField.)
	NavigateDescend	Přejde na další pole tvaru v pořadí navigace pro vybrané obrazce. (Zděděno z ShapeField.)
	NavigateToFirst	Přejde na první pole tvaru v pořadí navigace pro vybrané obrazce. (Zděděno z ShapeField.)
	NavigateToLast	Přejde na poslední pole obrazce v pořadí navigace pro vybrané obrazce. (Zděděno z ShapeField.)
	NavigateToNext	Přejde na další pole tvaru v pořadí navigace pro vybrané obrazce. (Zděděno z ShapeField.)
	NavigateToPrevious	Přejde na předchozí pole tvaru v pořadí navigace pro vybrané obrazce. (Zděděno z ShapeField.)
	OnBeginEdit	Upozornění posluchače při zahájení úpravy na místě. (Zděděno z ShapeField.)
	OnClick	Když uživatel klepne tvar pole upozornění posluchače. (Zděděno z ShapeField.)
	OnDoubleClick	Pokud má uživatel poklepali pole obrazec výstrahy posluchače. (Zděděno z ShapeField.)
	OnEndEdit	Po dokončení úpravy na místě oznámení posluchače. (Zděděno z ShapeField.)
	OnKeyDown	Když se uživatel rozhodl stisknutou klávesu, když přejdete pole obrazec výstrahy posluchače. (Zděděno z ShapeField.)
	OnKeyPress	Když uživatel stisknul klíč, když přejdete pole obrazec výstrahy posluchače. (Zděděno z ShapeField.)
	OnKeyUp	Když uživatel vydala klíč, pokud zvolíte pole obrazec výstrahy posluchače. (Zděděno z ShapeField.)
	OnMouseDown	Upozornění posluchače při uživatele podržení myši nad pole obrazce. (Zděděno z ShapeField.)
	OnMouseMove	Když byl přesunut myši přes pole obrazec výstrahy posluchače. (Zděděno z ShapeField.)
	OnMouseUp	Když uživatel vydala tlačítko myši nad pole obrazec výstrahy posluchače. (Zděděno z ShapeField.)
	OnMouseWheel	Upozornění posluchače při otočený myši přes pole obrazce. (Zděděno z ShapeField.)
	Selected	Načte pole obrazce a ověří, zda je zaškrtnuto. (Zděděno z ShapeField.)
	SetSelectionRange	Nastaví rozsah pole podřízené obrazce na výběr. (Zděděno z ShapeField.)
	SetValue	Zadaná hodnota přiřadí pole obrazce. (Zděděno z ShapeField.)
	SetVisible	Nastaví viditelnost pole obrazce. (Zděděno z ShapeField.)
	ToString	Vrací řetězec, který představuje aktuální objekt. (Zděděno z Object.)

Nahoru

Poznámky

Při definování decorator obraz ve tvaru a definovat tvar obrázku, oblast, ve které je obrazec zobrazen spravuje ImageField.Příklady inicializace ImageFields a jiných ShapeFields inspekci Dsl\GeneratedCode\Shapes.cs v řešení DSL.

ImageField je objekt, který spravuje oblast uvnitř tvaru, například místo přiřazené decorator.Jedna instance třídy ImageField je sdílet mezi mnoha obrazcům stejné třídy shape.Instance třídy ImageField neukládá samostatný obraz pro každý obrazec: místo, GetDisplayImage(ShapeElement) převezme tvar jako parametr metody a vyhledat obraz závislé na aktuální stav tvaru a jeho prvku modelu.

Pokud chcete zvláštní chování, jako je například proměnná obrazu, můžete vytvořit vlastní třídy odvozené od třídy ImageField.

Vytvoření podtřídy třídy ImageField

1. Nastavit Generuje dvojité odvozené vlastnost nadřazené třídy tvaru v DSL Definition.

2. Přepsat InitializeShapeFields metoda třídy shape.

   • Vytvořit nový soubor kód v projektu DSL a zapisovat třídy částečnou definici pro třídu obrazce.Přepsat definice metody existují.

3. Zkontrolovat kód InitializeShapeFields v DSL\GeneratedCode\Shapes.cs.

   Ve své metodě potlačení volání metody základní a potom vytvořit instanci třídy vlastní bitovou kopii pole.Umožňuje nahradit pravidelné obrazové pole v shapeFields seznam.

Příklady

Tento příklad vytvoří ikonu změnit závislé na stav prvku modelu obrazce.

Upozornění

Tento příklad ukazuje, jak vytvořit dynamický obrázek decorator.Ale pokud chcete přepínat mezi jeden nebo dva obrazy v závislosti na stavu proměnné modelu, je jednodušší vytvořit několik obrázků sklenářské, vyhledejte je ve stejné poloze na obrazci a pak nastavit filtr viditelnost, závisí na konkrétních hodnot proměnné modelu.Chcete-li nastavit filtr, vyberte obrazce map v definici DSL, otevřete okno podrobností DSL a kartu sklenářské.

Chcete-li spustit tento příklad kódu, vytvořte nové řešení DSL pomocí šablony minimální jazyk.Přidání domény booleovská vlastnost AlternateState ExampleElement třídy domény.Přidat decorator ikonu do třídy ExampleShape a nastavte jeho obraz na rastrový soubor.Klepněte na tlačítko transformace všechny šablony.Přidání nového souboru kód v projektu DSL a vložte následující kód.

Chcete-li otestovat kód stisknutím klávesy F5 a ladění řešení otevřete ukázkový diagram.Výchozí stav na ikonu se zobrazí.Vyberte obrazec a v okně Vlastnosti změňte hodnotu AlternateState vlastnost.Ikony by potom otočený až o 90 stupňů na obrazce.

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;
      }
    }
  }
}

Bezpečný přístup z více vláken

Všechny veřejné členy static (Shared v jazyce Visual Basic) tohoto typu jsou bezpečné pro přístup z více vláken. Není zaručeno, že členy instancí jsou bezpečné pro přístup z více vláken.

Viz také

Referenční dokumentace

Microsoft.VisualStudio.Modeling.Diagrams – obor názvů

TextField

ShapeField

InitializeShapeFields