beautypg.com

Chapter 24: the shared folder, The shared folder contents, The common folder – Adobe Extending Dreamweaver CS4 User Manual

Page 373

background image

367

Chapter 24: The Shared folder

The Shared folder is the central repository for utility functions, classes, and images that are commonly used by all
extensions. Any extension can reference the files in the Shared folder’s subfolders, and you can add custom common
utilities to the ones already provided by Adobe Dreamweaver. The multiple user Configuration folders installed for
users on Windows XP, Windows 2000, and Mac OS X platforms also contain a Shared folder for individual
customizations. For example, when you install an extension from the Adobe exchange, you might notice that the new
extension adds contents to your user Configuration/Shared folder rather than the Dreamweaver application
Configuration/Shared folder. For more information on the Dreamweaver Configuration folders on a multiuser
computer, see “

Multiuser Configuration folders

” on page 78.

The Shared folder contents

The Shared folder has subfolders that contain files shared by multiple extensions, including functions for browsing a
user’s folder system, inserting a tree control, creating editable grids, and other features.

Note: The JavaScript files in the Shared folder have comments within the code that provide details about the functions
they contain.

In addition to looking at the JavaScript files in the Shared folder, you should also search for HTML files in the
Configuration folder that include these JavaScript files so that you can investigate how they are used.

Generally, you use the functions and resources in the Common and MM folders or add resources to the Common
folder for use in new extensions. You should always look in the Shared/Common/Scripts folder first for utilities and
functions. These functions and utilities are the most current and comprise the formal interface to the Shared folder.
Use files in other folders at your own risk because they might be out of date.

Specifically, the Shared folder contains the following useful folders.

The Common folder

The Common folder has shared scripts and classes for use in third-party extensions.

File

Description

CodeBehindMgr.js

Contains functions for creating a code-behind document. A code-behind document lets you create
distinct pages that separate the code for user interface (UI) logic from the code for a UI design. The
methods of

JSCodeBehindMgr

defined in this file can create new code-behind documents and

manage the link to design documents.

ColumnValueNodeClass.js

Contains functions for mapping database columns to values. The methods of

ColumnValueNode

defined in this file let you get and set various values and properties of a database column.
Dreamweaver uses this storage class when applying and inspecting edit operations objects (insert and
update record objects) and working with the SQLStatement class.

CompilerClass.js

Contains functions for a base class used by

CompilerASPNetCSharp

and

CompilerASPNVBNet

but

could be extended to support other compilers.

DataSourceClass.js

Contains functions that define the return structure for “

findDynamicSources()

” on page

300.

This manual is related to the following products: