AIArtStyle.h File Reference

#include "AIArt.h"
#include "AIDictionary.h"
#include "AIPathStyle.h"
#include "AIPaintStyle.h"
#include "AIHeaderBegin.h"
#include "AIHeaderEnd.h"

Go to the source code of this file.

Classes
struct	AIArtStylePaintData
	Gradient information for AIArtStyleSuite::NewStyle() and AIArtStyleSuite::GetPaintAttributes(). More...
struct	AIArtStyleSuite
	The functions in the Art Style suite are used to access and modify art styles on artwork in Illustrator documents. More...
Defines
#define	kAIArtStyleSuite   "AI Art Style Suite"
#define	kAIArtStyleSuiteVersion8   AIAPI_VERSION(8)
#define	kAIArtStyleSuiteVersion   kAIArtStyleSuiteVersion8
#define	kAIArtStyleVersion   kAIArtStyleSuiteVersion
#define	kAINamedStyleListChangedNotifier   "AI Named Style List Changed Notifier"
	Sent when the list of styles in the Graphic Styles palette changes in any way, such as the order of the list, the names of the styles, deletions, additions, and so on.
#define	kAIArtStyleFocusChangedNotifier   "AI Art Style Focus Changed Notifier"
	Sent when the focus changes from the entire object to just the fill or stroke of the object, or the reverse.
#define	kAIArtStyleEditTransparencyNotifier   "AI Edit Transparency Notifier"
	Sent by the Appearance palette when the user double-clicks a transparency entry.
#define	kAINewArtBasicAppearancePref   "AI New Art Basic Appearance"
	An art style Preference key, a value for a suffix parameter in the AIPreferenceSuite functions, with a prefix value of NULL.
#define	kAIContainerOverridesObjectAppearancePref   "AI Container Overrides Object"
	An art style Preference key, a value for a suffix parameter in the AIPreferenceSuite functions, with a prefix value of NULL.
#define	kStyleNotInCurrentDocument   'STYD'
	Returned if an art style handle passed in does not exist in the current document.
#define	kStyleTypeNotCompatible   'STYP'
	Returned by AIArtStyleSuite::RedefineNamedStyle() if the style passed in is not a named style.
#define	kMaxStyleNameLength   63
	Maximum number of real characters in a style name.
Typedefs
typedef ai::uint32	AIArtStyleHasAttrs
	Return type for AIArtStyleSuite::ExamineStyle().
Enumerations
enum	AIArtStyleFocusValue { kAIFocusOnFillStroke, kAIFocusOnObject, kAIDummyFocus = 0xFFFFFF }
	Focus types, sent in notify data for kAIArtStyleFocusChangedNotifier. More...
enum	AIArtStyleType { kAIArtStyleSimple = 1, kAIArtStyleActive }
	Art style types. More...
enum	AIArtStyleHasAttrsBits {   kStyleHasNothing = 0, kStyleHasFill = 0x0001, kStyleHasStroke = 0x0002, kStyleHasPatterns = 0x0004,   kStyleHasCustomColors = 0x0008, kStyleHasFillGradients = 0x0010, kStyleHasRadialGradientsOnFill = 0x0020, kStyleHasTransparency = 0x0040,   kStyleHasBrushes = 0x0080, kStyleHasStrokeGradients = 0x0100, kStyleHasRadialGradientsOnStroke = 0x0200, kStyleHasEffects = 0x010000,   kStyleHasScalableEffects = 0x020000, kStyleCheckForAll = 0xffffffff }
	Bit flag value for style properties. More...

---

Detailed Description

---

Define Documentation

#define kAIArtStyleSuite   "AI Art Style Suite"

#define kAIArtStyleSuiteVersion   kAIArtStyleSuiteVersion8

#define kAIArtStyleSuiteVersion8   AIAPI_VERSION(8)

#define kAIArtStyleVersion   kAIArtStyleSuiteVersion

#define kAIContainerOverridesObjectAppearancePref   "AI Container Overrides Object"

An art style Preference key, a value for a suffix parameter in the AIPreferenceSuite functions, with a prefix value of NULL.

This preference controls whether Illustrator strips the fill and stroke colors off for all the text runs (that is, all the characters) when a user applies a graphic style to a text object. Controls the "Override Character Color" option in the Graphic Styles palette.

#define kAINewArtBasicAppearancePref   "AI New Art Basic Appearance"

An art style Preference key, a value for a suffix parameter in the AIPreferenceSuite functions, with a prefix value of NULL.

This preference controls whether new objects created by the user with the shape, brush, pen, or pencil tools inherit the full appearance currently displayed in the Appearance palette, or inherit only the current fill and stroke (with no transparency). This is tied to the "New Art Has Basic Appearance" option in the Appearance palette flyout menu.

#define kMaxStyleNameLength   63

Maximum number of real characters in a style name.

---

Typedef Documentation

typedef ai::uint32 AIArtStyleHasAttrs

Return type for AIArtStyleSuite::ExamineStyle().

See AIArtStyleHasAttrsBits for values.

---

Enumeration Type Documentation

enum AIArtStyleFocusValue

Focus types, sent in notify data for kAIArtStyleFocusChangedNotifier.

Enumerator:

kAIFocusOnFillStroke	focus changed to fill or stroke
kAIFocusOnObject	focus changed to object
kAIDummyFocus

enum AIArtStyleHasAttrsBits

Bit flag value for style properties.

A logical OR of these is returned by AIArtStyleSuite::ExamineStyle().

Enumerator:

kStyleHasNothing	null value
kStyleHasFill	Style has fill.
kStyleHasStroke	Style has stroke.
kStyleHasPatterns	Style has patterns.
kStyleHasCustomColors	Style has custom colors.
kStyleHasFillGradients	Style has gradients on Fill.
kStyleHasRadialGradientsOnFill	Style has radial gradients on Fill.
kStyleHasTransparency	Style has transparency.
kStyleHasBrushes	Style has brushes.
kStyleHasStrokeGradients	Style has gradients on Stroke.
kStyleHasRadialGradientsOnStroke	Style has radial gradients on Stoke.
kStyleHasEffects	Style has effects. Transparency does not count as an effect, but brushes do. If a style reports that it has no transparency or effects, but the type is kAIArtStyleActive, it has either multiple fills or strokes, or a stroke that is below the fill.
kStyleHasScalableEffects	Style has scalable effects.
kStyleCheckForAll	Pass to AIArtStyleSuite::ExamineStyle() to check for all possible attributes.

enum AIArtStyleType

Art style types.

Enumerator:

kAIArtStyleSimple	Style contains only one fill and one stroke and can have transparency applied only at the object level.
kAIArtStyleActive	Style can contain multiple fills and strokes, can have different transparency applied to each fill or stroke as well as to the object as a whole, and can contain Live Effects.