{"id":393,"date":"2013-07-03T14:28:49","date_gmt":"2013-07-03T14:28:49","guid":{"rendered":"http:\/\/elbsolutions.com\/projects\/?p=393"},"modified":"2022-02-03T11:25:04","modified_gmt":"2022-02-03T17:25:04","slug":"how-to-add-new-functions-to-the-autocad-menus","status":"publish","type":"post","link":"https:\/\/elbsolutions.com\/projects\/how-to-add-new-functions-to-the-autocad-menus\/","title":{"rendered":"How to add new functions to the AutoCad menus"},"content":{"rendered":"

<\/em>Creating a class for the new function using an existing class<\/h1>\n
    \n
  1. Open the class editor, then select the desired path.
    \n\"\"<\/li>\n
  2. Open any of the functions in the same subfolder that you want your function to be in.<\/li>\n
  3. Copy the name of the \u201cMethod Key\u201d, then search for the files in your porject directory using notepad ++ or a similar tool, using the file extension .ini. This will locate the folder\u00a0in your project directory that the class should be placed in.
    \n\"\"<\/li>\n
  4. There are 3 files which you need to place information into to create the class. These are class.ini, methods.ini and speckey.ini (speckey.ini is only needed if your function requires you to get data from a database file).<\/li>\n
  5. Create your new class by right clicking on the parent class and selecting \u201cinsert new component\u201d.<\/li>\n
  6. Enter a name and description. The name is the function that will be called from
    \nAutoCAD, it should have no spaces and be all upper case letters. The
    \ndescription is what will appear in the class editor, this name can include
    \nspaces and doesn\u2019t need to be uppercase. For example my name is TEST_FUNCTION, and the description is “This is a test function”.
    \n\"\"<\/li>\n
  7. Clicking \u00a0Ok will open your new class with default parameters associated with the parent.\u00a0We need to change the Methods and the Speckey. To modify the methods click on the button \u2018\u2026\u2019 to the right of it.<\/li>\n
  8. This will open the method\u2019s dialog box, click on the \u2018new key\u2019 button on the right\u00a0side of the dialog box. The name asked for by the new window will follow the same rules as the name in step 6.<\/li>\n
  9. Copy the same method key as the existing class you are basing your function off of. The functions called will stay the same as the ones in the method key you copied, they can only be changed from the methods.ini file.
    \n\"\"<\/li>\n
  10. Repeat steps 7-9 for the speckey, the speckey name and the methods name can be the same. Like the methods the speckey can only be edited from its speckey.ini file. When done click the save button in the Class Editor.<\/li>\n
  11. Open the class.ini file, new classes appear at the bottom of the file. Once you have found your class you can change the description, the method or speckey it uses and the picture that will be seen in the class editor. If no picture is desired
    \nthen this line can be removed.
    \n\"\"<\/li>\n
  12. Open the methods.ini file, the new methods appear at the bottom of the file. In your method you can change the file location and function name of the sub-method, such as the DRAW_METHOD. Change the desired sub method file location and function so that it looks like %APP_DIR%\\file_folder\\file_name ; FUNCTION_NAME
    \n\"\"<\/li>\n
  13. Open the speckey.ini file. The DISPLAY_FIELDS indicate which fields from the
    \ndatabase file are displayed when the function is run, the fields are shown in
    \nthe order they are written, the data will then be sorted alphabetically starting with the left most column. SPECKEY_SCRIPT should be left alone. The SPEC_TABLE indicates which table from your database file information will be used from. The WHERE_CLAUSE filters the data from the selected table, this section works in the same way as an if statement. Only rows that satisfies the clause will be displayed.
    \n\"\"<\/li>\n<\/ol>\n

    Adding a function to AutoCAD Menus, Tool Paletts, Tool Bars and Ribbons<\/h1>\n
      \n
    1. In AutoCAD open Tools->Customize->Interface.<\/li>\n
    2. Under the Command List select any command and choose duplicate under the right click menu.<\/li>\n
    3. Select the duplicated command (it will have the larger Element ID #), then change the command name to one that describes the function (this will be what appears in
      \nthe menus and tool palettes.\u00a0It will appear as a description in the ribbons and toolbars).<\/li>\n
    4. Change the macro so that it is ^C^C(at_Component_insert “AT_CABLET” “CLASS_NAME”),the first “” is dependant on which folder in the class editor you placed\u00a0your class in.\u00a0The second\u00a0“” must be the name of the class that uses your function.<\/li>\n
    5. Select a button image, this is what will appear in the tool palette and ribbon, if
      \nthere is no premade image in the list that fits your function create one using
      \nthe edit button.<\/p>\n

      Note : any changes made to the command name, description or picture will not automatically update. The command must be replaced in all menus, tool palettes and ribbons.<\/p><\/blockquote>\n<\/li>\n<\/ol>\n

      Menus<\/h2>\n
        \n
      1. Under the \u201cCustomizations in Main File\u201d select at_elect.cuix in the dropdown menu. This will allow changing menu items under “Raceways”.<\/li>\n
      2. Open menus->raceways, then either create a new sub menu under raceways or open more sub menus to reach a desired location.<\/li>\n
      3. Select your command from the Command List, then click and drag the command to the desired location.<\/li>\n<\/ol>\n

        Tool Palettes<\/h2>\n
          \n
        1. Open the desired tool palette, if it doesn’t exist create it using the customize
          \npalettes (from right clicking on the tool palette), right click the palettes
          \nbox and select new palette. Name the palette to describe the tool set<\/li>\n
        2. Now open the customize user interface window<\/li>\n
        3. Select your command from the command list and drag it onto the tool palette<\/li>\n<\/ol>\n

          Ribbons<\/h2>\n
            \n
          1. Under the \u201cCustomizations in Main File\u201d select at_elect.cuix in the dropdown menu.<\/li>\n
          2. Open Ribbons->Tabs->Raceways, right click on raceways and select new tab. The tab name is what will appear on the ribbon<\/li>\n
          3. Open Ribbons->Panels, right click on panels and select new panel. Name it the same as the tab you just created<\/li>\n<\/ol>\n

            Building the Ribbon Panel<\/h2>\n