Namngivning i användargränssnittet

En Dynamix-lösning består normalt av ett antal egendefinierade typer. Det kan röra sig om Dynamix-Objekt som modellerar t ex produkter eller händelser. Det kan vara enumerationer som modellerar olika inställningar. Eftersom det stora flertalet av gränssnitten skapas helt eller delvis automatiskt av Dynamix behöver man som utvecklare tala om för systemet hur objekt ska namnges i listor och kontroller.

Objekt

När det gäller objekt skiljer man mellan instansnamn och typnamn. Instansnamnet hämtas oftast ur en av objektets egenskaper eller ur en kombination av egenskaper. För ett produktobjekt kan det vara nameegenskapen och för en nyhetspost kanske det är rubrikegenskapen.

Rent praktiskt överlagras funktionen IName_Name i klasser som ärver från Dynamix.Object:

  1. C#
  2. VB
  1. protected override string IName_Name
  2. {
  3. get { return Name; }
  4. }

Instansnamnet används till exempel i listor över objekt:

Typnamnet används när systemet vill veta namnet på själva klassen av objekt. För en produkt är typnamnet "Produkt" och för en nyhet "Nyhet". Denna inställning görs genom att redigera .dx-filen i Visual Studio, fliken UI/Editiing

Andra typer av objekt

För att namnge instanser av klasser som inte ärver från Dynamix.Object implementeras interfacet Dynamix.IName

  1. C#
  2. VB
  1. public class MyClass : Dynamix.IName
  2. {
  3. public string Name
  4. {
  5. get { return ...; }
  6. }
  7. }

För typnamnet används attributet Dynamix.Ui5.NameAttribute:

  1. C#
  2. VB
  1. [Dynamix.Ui5.Name( Name="Min klass" )]
  2. public class MyClass : Dynamix.IName
  3. {
  4. ...
  5. }

Enumerationer

Enum är en inbyggd typ som inte går att ärva från. Vi kan alltså inte implementera IName direkt för våra enum-typer. Här används därför Dynamix Provider-teknik, dvs vi definierar en typ som kan svara på frågor om objekt av en annan typ, i det här fallet vår enum-typ. Provider-typen anges med attributet Dynamix.Ui5.NameProvider:

  1. C#
  2. VB
  1. [Dynamix.Ui5.NameProvider( ProviderType=typeof( MyEnumNameProvider ) )]
  2. public enum MyEnum
  3. {
  4. Red,
  5. Green,
  6. Blue
  7. }
  9. public class MyEnumNameProvider : INameProvider
  10. {
  11. public string GetName( object x )
  12. {
  13. var val = (MyEnum)x;
  14. switch( val )
  15. {
  16. case MyEnum.Red: return "Röd";
  17. case MyEnum.Green: return "Grön";
  18. case MyEnum.Blue: return "Blå";
  19. default: throw new ArgumentOutOfRangeException();
  20. }
  21. }
  22. }