Ikoner, beskrivningar och namngivning

I många gränssnittssammanhang, både deskriptor-/automatgenererade och egna är det praktiskt om objekt har ett generellt sätt att meddela gränssnittet hur de vill visa sig. Detta kan göras genom att implementera något av Dynamix beskrivningsinterface.

Dynamix.IName

Beskriver vad ett objekt anser är dess huvudsakliga namn. Dynamix.Object implementerar detta interface, så i klasser som ärvs därifrån sätter man eget namn genom att överlagra IName_Name:

  1. C#
  1. public class MyObject : Dynamix.Object
  2. {
  3. ...
  5. public string TheName
  6. {
  7. get ...
  8. set ...
  9. }
  11. protected override string IName_Name
  12. {
  13. get { return TheName; }
  14. }
  16. }

Dynamix.IDescription

Den enda medlemsmetoden Description ska returnera en beskrivning av objektet. Dynamix UI-kontroller använder denna beskrivning för att ge bra meddelanden och visa allmän information. Dynamix.Object implementerar detta interface, så i klasser som ärvs därifrån sätter man eget namn genom att överlagra IDescription_IName:

  1. C#
  1. public class MyObject : Dynamix.Object
  2. {
  3. ...
  5. public string TheDescription
  6. {
  7. get ...
  8. set ...
  9. }
  11. protected override string IDescription_Description
  12. {
  13. get { return TheDescription; }
  14. }
  16. }

Dynamix.UI.IDisplayItem

IDisplayItem innehåller tre medlemsmetoder, men två av dem - Name och Description - är märkta som Obsolete och ska numera alltid implementeras av IName och IDescription enligt ovan. Den tredje metoden - IconUrl - ska returnera sökvägen till en ikonbild som Dynamix UI-kontroller kan använda i de sammanhang det är lämpligt, exempelvis träd och listor. Dynamix.Object implementerar detta interface, så i klasser som ärvs därifrån sätter man eget namn genom att överlagra IDisplayItem_IconUrl

  1. C#
  1. public class MyObject : Dynamix.Object
  2. {
  3. ...
  5. protected override string IDisplayItem_IconUrl
  6. {
  7. get { return Dynamix.Util.Icon16( "star_yellow" ); }
  8. }
  9. }