Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 8 - Apple Event Terminology Resources / Creating an Apple Event Terminology Extension Resource

Supporting Standard Suites Without Extensions

To indicate that your application supports a standard suite in its entirety, without any extensions, your 'aete' resource needs to provide only the information that identifies the suite. For example, Listing 8-2 shows the Rez input for an 'aete' resource provided by an application that supports the entire Required and Core suites with no omissions or extensions.

Every 'aete' resource must provide the major and minor version numbers for the content of the resource (1 and 0 in Listing 8-2) and the language code (English in Listing 8-2). For each suite that an application supports in its entirety, without extensions, the 'aete' resource provides only the name, suite description, suite ID, suite level (1 for all current suites), and suite version (1 for all current suites). If the 'aete' resource provides an empty string as the human-language name for such a suite, a scripting component uses the name provided for the corresponding suite by the 'aeut' resource. If an application does not extend or omit any of the definitions in a standard suite, a scripting component can get the rest of the information about the suite--its event and object class definitions, comparison operators, and enumerated groups--from the 'aeut' resource. The corresponding arrays in the 'aete' resource can therefore be left empty.

Note that the Rez input for resources does not include the align word fields shown in the 'aeut' resource type declaration in Listing 8-1. Rez takes care of word alignment automatically.

Listing 8-2 Rez input for an 'aete' resource for an application that supports the Required and Core suites in their entirety

resource 'aete' (0, "JustTwoSuites") {
   1,                                     /*major version in BCD*/
   0,                                     /*minor version in BCD*/
   english,                               /*language code*/
   roman,                                 /*script code*/
   {  /*array Suites: 2 elements*/
      /*[1]*/
      "",                              /*human-language name for suite; */
                                       /* 'aeut' supplies "Required Suite"*/
      "Events that every application should support", /*suite description*/
      kAERequiredSuite,                   /*suite code*/
      1,                                  /*suite level*/
      1,                                  /*suite version*/
      {  /*array Events: 0 elements*/
      },
      {  /*array Classes: 0 elements*/
      },
      {  /*array ComparisonOps: 0 elements*/
      },
      {  /*array Enumerations: 0 elements*/
      },
      /*[2]*/
      "",                                 /*human-language name for suite; */
                                          /* 'aeut' supplies "Core Suite"*/
      "Suite that applies to all applications", /*suite description*/
      kAECoreSuite,                       /*suite code*/
      1,                                  /*suite level*/
      1,                                  /*suite version*/
      {  /*array Events: 0 element*/
      },

      {  /*array Classes: 0 elements*/
      },
      {  /*array ComparisonOps: 0 elements*/
      },
      {  /*array Enumerations: 0 elements*/
      }
   }
};