123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774 |
- {
- File: HIToolbox/HITheme.h
-
- Contains: HIToolbox HITheme interfaces.
-
- Version: HIToolbox-219.4.81~2
-
- Copyright: © 1994-2005 by Apple Computer, Inc., all rights reserved.
-
- Bugs?: For bug reports, consult the following page on
- the World Wide Web:
-
- http://www.freepascal.org/bugs.html
-
- }
- { Pascal Translation: Peter N Lewis, <[email protected]>, 2004 }
- { Pascal Translation Updated: Peter N Lewis, <[email protected]>, August 2005 }
- {
- Modified for use with Free Pascal
- Version 200
- Please report any bugs to <[email protected]>
- }
- {$mode macpas}
- {$packenum 1}
- {$macro on}
- {$inline on}
- {$CALLING MWPASCAL}
- unit HITheme;
- interface
- {$setc UNIVERSAL_INTERFACES_VERSION := $0342}
- {$setc GAP_INTERFACES_VERSION := $0200}
- {$ifc not defined USE_CFSTR_CONSTANT_MACROS}
- {$setc USE_CFSTR_CONSTANT_MACROS := TRUE}
- {$endc}
- {$ifc defined CPUPOWERPC and defined CPUI386}
- {$error Conflicting initial definitions for CPUPOWERPC and CPUI386}
- {$endc}
- {$ifc defined FPC_BIG_ENDIAN and defined FPC_LITTLE_ENDIAN}
- {$error Conflicting initial definitions for FPC_BIG_ENDIAN and FPC_LITTLE_ENDIAN}
- {$endc}
- {$ifc not defined __ppc__ and defined CPUPOWERPC}
- {$setc __ppc__ := 1}
- {$elsec}
- {$setc __ppc__ := 0}
- {$endc}
- {$ifc not defined __i386__ and defined CPUI386}
- {$setc __i386__ := 1}
- {$elsec}
- {$setc __i386__ := 0}
- {$endc}
- {$ifc defined __ppc__ and __ppc__ and defined __i386__ and __i386__}
- {$error Conflicting definitions for __ppc__ and __i386__}
- {$endc}
- {$ifc defined __ppc__ and __ppc__}
- {$setc TARGET_CPU_PPC := TRUE}
- {$setc TARGET_CPU_X86 := FALSE}
- {$elifc defined __i386__ and __i386__}
- {$setc TARGET_CPU_PPC := FALSE}
- {$setc TARGET_CPU_X86 := TRUE}
- {$elsec}
- {$error Neither __ppc__ nor __i386__ is defined.}
- {$endc}
- {$setc TARGET_CPU_PPC_64 := FALSE}
- {$ifc defined FPC_BIG_ENDIAN}
- {$setc TARGET_RT_BIG_ENDIAN := TRUE}
- {$setc TARGET_RT_LITTLE_ENDIAN := FALSE}
- {$elifc defined FPC_LITTLE_ENDIAN}
- {$setc TARGET_RT_BIG_ENDIAN := FALSE}
- {$setc TARGET_RT_LITTLE_ENDIAN := TRUE}
- {$elsec}
- {$error Neither FPC_BIG_ENDIAN nor FPC_LITTLE_ENDIAN are defined.}
- {$endc}
- {$setc ACCESSOR_CALLS_ARE_FUNCTIONS := TRUE}
- {$setc CALL_NOT_IN_CARBON := FALSE}
- {$setc OLDROUTINENAMES := FALSE}
- {$setc OPAQUE_TOOLBOX_STRUCTS := TRUE}
- {$setc OPAQUE_UPP_TYPES := TRUE}
- {$setc OTCARBONAPPLICATION := TRUE}
- {$setc OTKERNEL := FALSE}
- {$setc PM_USE_SESSION_APIS := TRUE}
- {$setc TARGET_API_MAC_CARBON := TRUE}
- {$setc TARGET_API_MAC_OS8 := FALSE}
- {$setc TARGET_API_MAC_OSX := TRUE}
- {$setc TARGET_CARBON := TRUE}
- {$setc TARGET_CPU_68K := FALSE}
- {$setc TARGET_CPU_MIPS := FALSE}
- {$setc TARGET_CPU_SPARC := FALSE}
- {$setc TARGET_OS_MAC := TRUE}
- {$setc TARGET_OS_UNIX := FALSE}
- {$setc TARGET_OS_WIN32 := FALSE}
- {$setc TARGET_RT_MAC_68881 := FALSE}
- {$setc TARGET_RT_MAC_CFM := FALSE}
- {$setc TARGET_RT_MAC_MACHO := TRUE}
- {$setc TYPED_FUNCTION_POINTERS := TRUE}
- {$setc TYPE_BOOL := FALSE}
- {$setc TYPE_EXTENDED := FALSE}
- {$setc TYPE_LONGLONG := TRUE}
- uses MacTypes,CFBase,CGBase,Appearance,HIShape,HIGeometry,Drag,CFDate,CGContext,MacWindows,Controls;
- {$ALIGN MAC68K}
- { -------------------------------------------------------------------------- }
- { HIThemeOrientation information }
- { -------------------------------------------------------------------------- }
- const
- {
- * The passed context has an origin at the top left. This is the
- * default of a context passed to you by HIToolbox.
- }
- kHIThemeOrientationNormal = 0;
- {
- * The passed context has an origin at the bottom left. This is the
- * default for a context you create.
- }
- kHIThemeOrientationInverted = 1;
- type
- HIThemeOrientation = UInt32;
- { -------------------------------------------------------------------------- }
- { Splitter types }
- { -------------------------------------------------------------------------- }
- const
- {
- * Draw the splitter with its normal appearance.
- }
- kHIThemeSplitterAdornmentNone = 0;
- {
- * Draw the splitter with its metal appearance.
- }
- kHIThemeSplitterAdornmentMetal = 1;
- type
- HIThemeSplitterAdornment = UInt32;
- { -------------------------------------------------------------------------- }
- { Window Grow Box }
- { -------------------------------------------------------------------------- }
- const
- {
- * The grow box corner for a window that has no scroll bars.
- }
- kHIThemeGrowBoxKindNormal = 0;
- {
- * The grow box corner for a window that has no grow box. This sounds
- * paradoxical, but this type of grow box, formerly known as the
- * "NoGrowBox" is used to fill in the corner left blank by the
- * intersection of a horizontal and a vertical scroll bar.
- }
- kHIThemeGrowBoxKindNone = 1;
- type
- HIThemeGrowBoxKind = UInt32;
- const
- {
- * Draw the grow box for normal windows.
- }
- kHIThemeGrowBoxSizeNormal = 0;
- {
- * Draw the smaller grow box for utility or floating windows.
- }
- kHIThemeGrowBoxSizeSmall = 1;
- type
- HIThemeGrowBoxSize = UInt32;
- const
- {
- * The group box is drawn with the primary variant.
- }
- kHIThemeGroupBoxKindPrimary = 0;
- {
- * The group box is drawn with the secondary variant.
- }
- kHIThemeGroupBoxKindSecondary = 1;
- {
- * The group box is drawn with the primary variant. This group box
- * draws opaque. This does not match the Mac OS X 10.3 appearance
- * 100%, as the boxes should be transparent, but draws this way for
- * the sake of compatibility. Please update to use the newer
- * transparent variant.
- }
- kHIThemeGroupBoxKindPrimaryOpaque = 3;
- {
- * The group box is drawn with the secondary variant. This group box
- * draws opaque. This does not match the Mac OS X 10.3 appearance
- * 100%, as the boxes should be transparent, but draws this way for
- * the sake of compatibility. Please update to use the newer
- * transparent variant.
- }
- kHIThemeGroupBoxKindSecondaryOpaque = 4;
- type
- HIThemeGroupBoxKind = UInt32;
- const
- {
- * A header drawn above window content that has no top border of its
- * own. (i.e. the same as the status bar in an icon view Finder
- * window).
- }
- kHIThemeHeaderKindWindow = 0;
- {
- * A header drawn above window content that has a top border of its
- * own. (i.e. the same as the status bar in an list view Finder
- * window).
- }
- kHIThemeHeaderKindList = 1;
- type
- HIThemeHeaderKind = UInt32;
- const
- {
- * The default sized square text field (like Edit Text).
- }
- kHIThemeFrameTextFieldSquare = 0;
- kHIThemeFrameListBox = 1;
- type
- HIThemeFrameKind = UInt32;
- const
- {
- * Indicates that a menu title should be drawn in a condensed
- * appearance. This constant is used in the
- * HIThemeMenuTitleDrawInfo.attributes field.
- }
- kHIThemeMenuTitleDrawCondensed = 1 shl 0;
- { -------------------------------------------------------------------------- }
- { DrawInfo }
- { -------------------------------------------------------------------------- }
- {
- * HIScrollBarTrackInfo
- *
- * Summary:
- * Drawing parameters passed to scroll bar drawing and measuring
- * theme APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIScrollBarTrackInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeTrackEnableState for the scroll bar to be drawn.
- }
- enableState: SInt8 {ThemeTrackEnableState};
- {
- * The ThemeTrackPressState for the scroll bar to be drawn.
- }
- pressState: SInt8 {ThemeTrackPressState};
- {
- * The view range size.
- }
- viewsize: Float32;
- end;
- HIScrollBarTrackInfoPtr = ^HIScrollBarTrackInfo;
- {
- * HIThemeTrackDrawInfo
- *
- * Summary:
- * Drawing parameters passed to track drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3, but based on legacy TrackDrawInfo.
- }
- type
- HIThemeTrackDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32; { current version is 0 }
- {
- * The ThemeTrackKind of the track being drawn or measured.
- }
- kind: ThemeTrackKind; { what kind of track this info is for }
- {
- * An HIRect describing the bounds of the track being drawn or
- * measured.
- }
- bounds: HIRect; { track basis rectangle }
- {
- * The minimum allowable value for the track being drawn or measured.
- }
- min: SInt32; { min track value }
- {
- * The maximum allowable value for the track being drawn or measured.
- }
- max: SInt32; { max track value }
- {
- * The value for the track being drawn or measured.
- }
- value: SInt32; { current thumb value }
- {
- * Leave this reserved field set to 0.
- }
- reserved: UInt32;
- {
- * A set of ThemeTrackAttributes for the track to be drawn or
- * measured.
- }
- attributes: ThemeTrackAttributes; { various track attributes }
- {
- * A ThemeTrackEnableState describing the state of the track to be
- * drawn or measured.
- }
- enableState: SInt8 {ThemeTrackEnableState}; { enable state }
- {
- * Leave this reserved field set to 0.
- }
- filler1: SInt8;
- case SInt16 of
- 0: (
- scrollbar: ScrollBarTrackInfo;
- );
- 1: (
- slider: SliderTrackInfo;
- );
- 2: (
- progress: ProgressTrackInfo;
- );
- end;
- HIThemeTrackDrawInfoPtr = ^HIThemeTrackDrawInfo;
- {
- * HIThemeAnimationTimeInfo
- *
- * Summary:
- * Time parameters passed to button drawing and measuring theme APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeAnimationTimeInfo = record
- {
- * The CFAbsoluteTime of the beginning of the animation of the
- * button. This only applies to buttons that animate -- currently
- * only kThemePushButton. All other buttons will ignore this field.
- * If there is to be no animation, set this field to 0.
- }
- start: CFAbsoluteTime;
- {
- * The CFAbsoluteTime of the current animation frame of the button.
- * This only applies to buttons that animate -- currently only
- * kThemePushButton. All other buttons will ignore this field. If
- * there is to be no animation, set this field to 0.
- }
- current: CFAbsoluteTime;
- end;
- HIThemeAnimationTimeInfoPtr = ^HIThemeAnimationTimeInfo;
- {
- * HIThemeAnimationFrameInfo
- *
- * Summary:
- * Frame parameters passed to button drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeAnimationFrameInfo = record
- {
- * The index of the frame of the animation to draw. If the index is
- * greater that the maximum number of animation frames, it will be
- * modded to calculate which frame to draw.
- }
- index: UInt32;
- end;
- HIThemeAnimationFrameInfoPtr = ^HIThemeAnimationFrameInfo;
- {
- * HIThemeButtonDrawInfo
- *
- * Summary:
- * Drawing parameters passed to button drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeButtonDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState of the button being drawn or measured.
- }
- state: ThemeDrawState;
- {
- * A ThemeButtonKind indicating the type of button to be drawn.
- }
- kind: ThemeButtonKind;
- {
- * The ThemeButtonValue of the button being drawn or measured.
- }
- value: ThemeButtonValue;
- {
- * The ThemeButtonAdornment(s) with which the button is being drawn
- * or measured.
- }
- adornment: ThemeButtonAdornment;
- case SInt16 of
- 0: (
- time: HIThemeAnimationTimeInfo;
- );
- 1: (
- frame: HIThemeAnimationFrameInfo;
- );
- end;
- HIThemeButtonDrawInfoPtr = ^HIThemeButtonDrawInfo;
- {
- * HIThemeSplitterDrawInfo
- *
- * Summary:
- * Drawing parameters passed to splitter drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeSplitterDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState of the splitter being drawn or measured.
- }
- state: ThemeDrawState;
- {
- * The HIThemeSplitterAdornments of the splitter being drawn or
- * measured.
- }
- adornment: HIThemeSplitterAdornment;
- end;
- HIThemeSplitterDrawInfoPtr = ^HIThemeSplitterDrawInfo;
- const
- {
- * No tab adornments are to be drawn.
- }
- kHIThemeTabAdornmentNone = 0;
- {
- * A focus ring is to be drawn around the tab.
- }
- kHIThemeTabAdornmentFocus = 1 shl 2; { to match button focus adornment }
- {
- * If available, a leading separator is to be drawn on the tab,
- * either to the left or above, depending on orientation. Note that
- * tabs overlap and if the separators are drawn over top each other,
- * the shadows multiply undesirably. New in Mac OS X 10.4.
- }
- kHIThemeTabAdornmentLeadingSeparator = 1 shl 3;
- {
- * If available, a right separator is to be drawn on the tab, either
- * to the right or below, depending on the orientation. Note that
- * tabs overlap and if the separators are drawn over top each other,
- * the shadows multiply undesirably. New in Mac OS X 10.4.
- }
- kHIThemeTabAdornmentTrailingSeparator = 1 shl 4;
- type
- HIThemeTabAdornment = UInt32;
- {
- * Summary:
- * These values are similar to kControlSize constants for
- * convenience.
- }
- const
- {
- * The tabs are normal (large) sized.
- }
- kHIThemeTabSizeNormal = 0;
- {
- * The tabs are drawn as the small variant.
- }
- kHIThemeTabSizeSmall = 1;
- {
- * The tabs are drawn as the mini variant.
- }
- kHIThemeTabSizeMini = 3;
- type
- HIThemeTabSize = UInt32;
- {
- * Summary:
- * Available values for HIThemeTabPosition. These are positions of
- * the tabs within the tab control. New in Mac OS X 10.4.
- }
- const
- {
- * The first position of a tab control. Left or top tab.
- }
- kHIThemeTabPositionFirst = 0;
- {
- * A middle tab.
- }
- kHIThemeTabPositionMiddle = 1;
- {
- * The last position of a tab control. Right or bottom tab.
- }
- kHIThemeTabPositionLast = 2;
- {
- * The only position of a tab control. It is simultaneously first and
- * last. You know, only. There is only one tab. It looks pretty much
- * like a button. Please don't use this if you can avoid it. It's
- * ugly.
- }
- kHIThemeTabPositionOnly = 3;
- type
- HIThemeTabPosition = UInt32;
- {
- * Summary:
- * Available values for HIThemeTabKind.
- }
- const
- kHIThemeTabKindNormal = 0;
- type
- HIThemeTabKind = UInt32;
- {
- * HIThemeTabDrawInfo
- *
- * Summary:
- * Drawing parameters passed to tab drawing and measuring theme APIs.
- *
- * Discussion:
- * In Mac OS X 10.4, added kind and position fields.
- }
- type
- HIThemeTabDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 1.
- }
- version: UInt32;
- {
- * A ThemeTabStyle describing the style of the tab to be drawn.
- }
- style: ThemeTabStyle;
- {
- * A ThemeTabDirection describing the side on which the tab is being
- * drawn.
- }
- direction: ThemeTabDirection;
- {
- * An HIThemeTabSize indicating what size of tab to draw.
- }
- size: HIThemeTabSize;
- {
- * An HIThemeTabAdornment describing any additional adornments that
- * are to be drawn on the tab.
- }
- adornment: HIThemeTabAdornment; { various tab attributes }
- {
- * An HIThemeTabKind indicating what kind of tab to draw.
- }
- kind: HIThemeTabKind;
- {
- * The HIThemeTabPositions of the tab to be drawn or measured.
- }
- position: HIThemeTabPosition;
- end;
- HIThemeTabDrawInfoPtr = ^HIThemeTabDrawInfo;
- {
- * HIThemeTabDrawInfoVersionZero
- *
- * Summary:
- * This structure is left here as a reference to the previous
- * version of the tab drawing parameters. Please use the current
- * version.
- *
- * Discussion:
- * Shipped with Mac OS X 10.3.
- }
- type
- HIThemeTabDrawInfoVersionZero = record
- version: UInt32;
- style: ThemeTabStyle;
- direction: ThemeTabDirection;
- size: HIThemeTabSize;
- adornment: HIThemeTabAdornment; { various tab attributes }
- end;
- {
- * Summary:
- * Values for HIThemeTabPaneAdornment.
- }
- const
- kHIThemeTabPaneAdornmentNormal = 0;
- type
- HIThemeTabPaneAdornment = UInt32;
- {
- * HIThemeTabPaneDrawInfo
- *
- * Summary:
- * Drawing parameters passed to tab pane drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * In Mac OS X 10.4, added kind and adornment fields.
- }
- type
- HIThemeTabPaneDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the tab pane to be drawn.
- }
- state: ThemeDrawState;
- {
- * A ThemeTabDirection describing on which side of the pane the tabs
- * will be drawn.
- }
- direction: ThemeTabDirection;
- {
- * An HIThemeTabSize indicating what size of tab pane to draw.
- }
- size: HIThemeTabSize;
- {
- * An HIThemeTabKind indicating what kind of tab to draw this pane
- * for.
- }
- kind: HIThemeTabKind;
- {
- * An HIThemeTabPaneAdornment describing any additional adornments
- * that are to be drawn on the tab pane.
- }
- adornment: HIThemeTabPaneAdornment;
- end;
- {
- * HIThemeTabPaneDrawInfoVersionZero
- *
- * Summary:
- * This structure is left here as a reference to the previous
- * version of the tab pane drawing parameters. Please use the
- * current version.
- *
- * Discussion:
- * Shipped with Mac OS X 10.3.
- }
- type
- HIThemeTabPaneDrawInfoVersionZero = record
- version: UInt32;
- state: ThemeDrawState;
- direction: ThemeTabDirection;
- size: HIThemeTabSize;
- end;
- {
- * HIThemeMenuDrawInfo
- *
- * Summary:
- * Drawing parameters passed to menu drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeMenuDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * A ThemeMenuType indicating which type of menu is to be drawn.
- }
- menuType: ThemeMenuType;
- end;
- HIThemeMenuDrawInfoPtr = ^HIThemeMenuDrawInfo;
- {
- * HIThemeMenuItemDrawInfo
- *
- * Summary:
- * Drawing parameters passed to menu item drawing and measuring
- * theme APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeMenuItemDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * A ThemeMenuItemType indicating what type of menu item is to be
- * drawn.
- }
- itemType: ThemeMenuItemType;
- {
- * The ThemeMenuState of the menu item to be drawn.
- }
- state: ThemeMenuState;
- end;
- HIThemeMenuItemDrawInfoPtr = ^HIThemeMenuItemDrawInfo;
- {
- * HIThemeFrameDrawInfo
- *
- * Summary:
- * Drawing parameters passed to frame drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeFrameDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The HIThemeFrameKind of the frame to be drawn.
- }
- kind: HIThemeFrameKind;
- {
- * The ThemeDrawState of the frame to be drawn.
- }
- state: ThemeDrawState;
- {
- * A Boolean indicating whether the frame is to be drawn with focus
- * or without.
- }
- isFocused: Boolean;
- end;
- HIThemeFrameDrawInfoPtr = ^HIThemeFrameDrawInfo;
- {
- * HIThemeGroupBoxDrawInfo
- *
- * Summary:
- * Drawing parameters passed to group box drawing and measuring
- * theme APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeGroupBoxDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the group box to be drawn.
- }
- state: ThemeDrawState;
- {
- * An HIThemeGroupBoxKind indicating which type of group box is to be
- * drawn.
- }
- kind: HIThemeGroupBoxKind;
- end;
- HIThemeGroupBoxDrawInfoPtr = ^HIThemeGroupBoxDrawInfo;
- {
- * HIThemeGrabberDrawInfo
- *
- * Summary:
- * Drawing parameters passed to grabber drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeGrabberDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the grabber to be drawn.
- }
- state: ThemeDrawState;
- end;
- HIThemeGrabberDrawInfoPtr = ^HIThemeGrabberDrawInfo;
- {
- * HIThemePlacardDrawInfo
- *
- * Summary:
- * Drawing parameters passed to placard drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemePlacardDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the placard to be drawn.
- }
- state: ThemeDrawState;
- end;
- HIThemePlacardDrawInfoPtr = ^HIThemePlacardDrawInfo;
- {
- * HIThemeHeaderDrawInfo
- *
- * Summary:
- * Drawing parameters passed to header drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeHeaderDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the header to be drawn.
- }
- state: ThemeDrawState;
- {
- * The HIThemeHeaderKind for the header to be drawn.
- }
- kind: HIThemeHeaderKind;
- end;
- HIThemeHeaderDrawInfoPtr = ^HIThemeHeaderDrawInfo;
- {
- * HIThemeMenuBarDrawInfo
- *
- * Summary:
- * Drawing parameters passed to HIThemeDrawMenuBarBackground.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeMenuBarDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeMenuBarState for the menu bar to be drawn.
- }
- state: ThemeMenuBarState;
- {
- * The attributes of the menu bar to be drawn.
- }
- attributes: UInt32;
- end;
- HIThemeMenuBarDrawInfoPtr = ^HIThemeMenuBarDrawInfo;
- {
- * HIThemeMenuTitleDrawInfo
- *
- * Summary:
- * Drawing parameters passed to HIThemeDrawMenuTitle.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeMenuTitleDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeMenuState for the menu title to be drawn.
- }
- state: ThemeMenuState;
- {
- * The attributes of the menu title to be drawn. Must be either 0 or
- * kHIThemeMenuTitleDrawCondensed.
- }
- attributes: UInt32;
- {
- * The border space between the menu title rect and the menu title
- * text when the menu title spacing is being condensed. This field is
- * only observed by the Appearance Manager when the attributes field
- * contains kHIThemeMenuTitleDrawCondensed. The valid values for this
- * field range from the value returned by GetThemeMenuTitleExtra(
- * &extra, false ) to the value returned by GetThemeMenuTitleExtra(
- * &extra, true ). You may pass 0 in this field to use the minimum
- * condensed title extra.
- }
- condensedTitleExtra: Float32;
- end;
- HIThemeMenuTitleDrawInfoPtr = ^HIThemeMenuTitleDrawInfo;
- {
- * HIThemeTickMarkDrawInfo
- *
- * Summary:
- * Drawing parameters passed to tick mark drawing and measuring
- * theme APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeTickMarkDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the tick mark to be drawn.
- }
- state: ThemeDrawState;
- end;
- HIThemeTickMarkDrawInfoPtr = ^HIThemeTickMarkDrawInfo;
- {
- * HIThemeWindowDrawInfo
- *
- * Summary:
- * Drawing parameters passed to window drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3, but based on legacy ThemeWindowMetrics.
- }
- type
- HIThemeWindowDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * A ThemeDrawState which describes the state of the window to be
- * drawn.
- }
- state: ThemeDrawState;
- {
- * A ThemeWindowType specifying the type of window to be drawn.
- }
- windowType: ThemeWindowType;
- {
- * The ThemeWindowAttributes describing the window to be drawn.
- }
- attributes: ThemeWindowAttributes;
- {
- * The height of the title of the window.
- }
- titleHeight: Float32;
- {
- * The width of the title of the window.
- }
- titleWidth: Float32;
- end;
- HIThemeWindowDrawInfoPtr = ^HIThemeWindowDrawInfo;
- {
- * HIThemeWindowWidgetDrawInfo
- *
- * Summary:
- * Drawing parameters passed to window widget drawing and measuring
- * theme APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3, but based on legacy ThemeWindowMetrics.
- }
- type
- HIThemeWindowWidgetDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * A ThemeDrawState which describes the state of the widget to be
- * drawn.
- }
- widgetState: ThemeDrawState;
- {
- * A ThemeTitleBarWidget specifying the type of window widget to be
- * drawn.
- }
- widgetType: ThemeTitleBarWidget;
- {
- * A ThemeDrawState which describes the state of the window for which
- * the widget is to be drawn.
- }
- windowState: ThemeDrawState;
- {
- * A ThemeWindowType specifying the type of window to be drawn.
- }
- windowType: ThemeWindowType;
- {
- * The ThemeWindowAttributes describing the window to be drawn.
- }
- attributes: ThemeWindowAttributes;
- {
- * The height of the title of the window.
- }
- titleHeight: Float32;
- {
- * The width of the title of the window.
- }
- titleWidth: Float32;
- end;
- HIThemeWindowWidgetDrawInfoPtr = ^HIThemeWindowWidgetDrawInfo;
- {
- * HIThemeSeparatorDrawInfo
- *
- * Summary:
- * Drawing parameters passed to separator drawing and measuring
- * theme APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeSeparatorDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the separator to be drawn.
- }
- state: ThemeDrawState;
- end;
- HIThemeSeparatorDrawInfoPtr = ^HIThemeSeparatorDrawInfo;
- {
- * HIThemeScrollBarDelimitersDrawInfo
- *
- * Summary:
- * Drawing parameters passed to separator drawing and measuring
- * theme APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeScrollBarDelimitersDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the separator to be drawn.
- }
- state: ThemeDrawState;
- {
- * A ThemeWindowType specifying the type of window for which to draw
- * the delimiters.
- }
- windowType: ThemeWindowType;
- {
- * The ThemeWindowAttributes of the window for which the scroll bar
- * delimters are to be drawn.
- }
- attributes: ThemeWindowAttributes;
- end;
- HIThemeScrollBarDelimitersDrawInfoPtr = ^HIThemeScrollBarDelimitersDrawInfo;
- {
- * HIThemeChasingArrowsDrawInfo
- *
- * Summary:
- * Drawing parameters passed to chasing arrows drawing and measuring
- * theme APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeChasingArrowsDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the chasing arrows to be drawn.
- }
- state: ThemeDrawState;
- {
- * A UInt32 used to calculate which frame of the chasing arrow
- * animation is to be drawn.
- }
- index: UInt32;
- end;
- HIThemeChasingArrowsDrawInfoPtr = ^HIThemeChasingArrowsDrawInfo;
- {
- * HIThemePopupArrowDrawInfo
- *
- * Summary:
- * Drawing parameters passed to popup arrow drawing and measuring
- * theme APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemePopupArrowDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the popup arrow to be drawn.
- }
- state: ThemeDrawState;
- {
- * A ThemeArrowOrientation for the orientation of the popup arrow to
- * be drawn.
- }
- orientation: ThemeArrowOrientation;
- {
- * A ThemePopupArrowSize for the size of the popup arrow to be drawn.
- }
- size: ThemePopupArrowSize;
- end;
- HIThemePopupArrowDrawInfoPtr = ^HIThemePopupArrowDrawInfo;
- {
- * HIThemeGrowBoxDrawInfo
- *
- * Summary:
- * Drawing parameters passed to grow box drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3.
- }
- type
- HIThemeGrowBoxDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the grow box to be drawn.
- }
- state: ThemeDrawState;
- {
- * A ThemeGrowBoxKind indicating in which kind of grow box to draw.
- }
- kind: HIThemeGrowBoxKind;
- {
- * A ThemeGrowDirection indicating in which direction the window will
- * grow.
- }
- direction: ThemeGrowDirection;
- {
- * An HIThemeGrowBoxSize describing the size of the grow box to draw.
- }
- size: HIThemeGrowBoxSize;
- end;
- HIThemeGrowBoxDrawInfoPtr = ^HIThemeGrowBoxDrawInfo;
- {
- * HIThemeBackgroundDrawInfo
- *
- * Discussion:
- * New in Mac OS X 10.3, but based on legacy TrackDrawInfo.
- }
- type
- HIThemeBackgroundDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState of the background to be drawn. Currently,
- * HIThemeDrawBackground backgrounds do not have state, so this field
- * has no meaning. Set it to kThemeStateActive.
- }
- state: ThemeDrawState;
- {
- * The ThemeBackgroundKind with which to fill the background.
- }
- kind: ThemeBackgroundKind;
- end;
- HIThemeBackgroundDrawInfoPtr = ^HIThemeBackgroundDrawInfo;
- { -------------------------------------------------------------------------- }
- { Buttons }
- { -------------------------------------------------------------------------- }
- {
- * HIThemeDrawButton()
- *
- * Summary:
- * Draw a themed button.
- *
- * Discussion:
- * This generic button drawing theme primitive draws not just a push
- * button, but all of the kinds of buttons described by
- * ThemeButtonKind.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * The HIRect in which to draw. Note that this API may draw
- * outside of its bounds.
- *
- * inDrawInfo:
- * An HIThemeButtonDrawInfo describing the button that will be
- * drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * outLabelRect:
- * A pointer to an HIRect into which to put the bounds of the
- * label rect.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawButton( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemeButtonDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation; outLabelRect: HIRectPtr { can be NULL } ): OSStatus; external name '_HIThemeDrawButton';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetButtonShape()
- *
- * Summary:
- * Get a shape of a themed button.
- *
- * Discussion:
- * This API was mistakenly named as a "Get" API. It behaves as
- * "Copy" API. THE CALLER IS RESPONSIBLE FOR RELEASING THE RETURNED
- * SHAPE.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * An HIThemeButtonDrawInfo describing the button that will be
- * drawn.
- *
- * outShape:
- * A pointer to an HIShapeRef which will be set to the shape of
- * the button. Needs to be released by caller.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetButtonShape( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemeButtonDrawInfo; var outShape: HIShapeRef ): OSStatus; external name '_HIThemeGetButtonShape';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetButtonContentBounds()
- *
- * Summary:
- * Get the bounds of a themed button's content.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * An HIRect indicating where the button is to be drawn.
- *
- * inDrawInfo:
- * An HIThemeButtonDrawInfo describing the button that will be
- * drawn.
- *
- * outBounds:
- * A pointer to an HIRect in which will be returned the rectangle
- * of the button content bounds.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetButtonContentBounds( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemeButtonDrawInfo; var outBounds: HIRect ): OSStatus; external name '_HIThemeGetButtonContentBounds';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetButtonBackgroundBounds()
- *
- * Summary:
- * Get the bounds of the background of a themed button.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * An HIRect indicating where the button is to be drawn.
- *
- * inDrawInfo:
- * An HIThemeButtonDrawInfo describing the button that will be
- * drawn.
- *
- * outBounds:
- * A pointer to an HIRect in which will be returned the rectangle
- * of the button background bounds.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetButtonBackgroundBounds( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemeButtonDrawInfo; var outBounds: HIRect ): OSStatus; external name '_HIThemeGetButtonBackgroundBounds';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawChasingArrows()
- *
- * Summary:
- * Draw themed chasing arrows.
- *
- * Discussion:
- * Draw a frame from the chasing arrows animation. The animation
- * frame is based on a modulo value calculated from the index.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * An HIRect indicating where the chasing arrows are to be drawn.
- *
- * inDrawInfo:
- * An HIThemeChasingArrowsDrawInfo describing the chasing arrows
- * to be drawn or measured.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawChasingArrows( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemeChasingArrowsDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawChasingArrows';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawPopupArrow()
- *
- * Summary:
- * Draws a themed popup arrow.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * An HIThemePopupArrowDrawInfo describing the popup arrow to be
- * drawn or measured.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawPopupArrow( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemePopupArrowDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawPopupArrow';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- { -------------------------------------------------------------------------- }
- { Menus }
- { -------------------------------------------------------------------------- }
- {
- * HIThemeDrawMenuBarBackground()
- *
- * Summary:
- * Draws the menu bar background for a given area.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * The HIThemeMenuBarDrawInfo of the menu bar to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawMenuBarBackground( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemeMenuBarDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawMenuBarBackground';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawMenuTitle()
- *
- * Summary:
- * Draws the menu title background for a menu.
- *
- * Discussion:
- * This API draws the background of a menu title. It does not draw
- * the menu title text; it is the caller's responsibility to draw
- * the text after this API has returned. The text should be drawn
- * into the bounds returned in the outLabelRect parameter; the
- * caller should ensure that the text is not drawn outside of those
- * bounds, either by truncating or clipping the text.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inMenuBarRect:
- * An HIRect indicating the bounds of the whole menu bar for which
- * the menu title is to be drawn.
- *
- * inTitleRect:
- * An HIRect for the bounds of the menu title to be drawn.
- *
- * inDrawInfo:
- * The HIThemeMenuTitleDrawInfo of the menu title to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * outLabelRect:
- * On exit, contains the bounds in which the menu title text
- * should be drawn. May be NULL if you don't need this information.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawMenuTitle( const (*var*) inMenuBarRect: HIRect; const (*var*) inTitleRect: HIRect; const (*var*) inDrawInfo: HIThemeMenuTitleDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation; outLabelRect: HIRectPtr { can be NULL } ): OSStatus; external name '_HIThemeDrawMenuTitle';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawMenuBackground()
- *
- * Summary:
- * Draws the theme menu background in a rectangle. This API may
- * draw outside of the specified rectangle.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inMenuRect:
- * An HIRect indicating the bounds of the whole menu for which the
- * background is to be drawn.
- *
- * inMenuDrawInfo:
- * An HIThemeMenuDrawInfo describing the menu to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawMenuBackground( const (*var*) inMenuRect: HIRect; const (*var*) inMenuDrawInfo: HIThemeMenuDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawMenuBackground';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawMenuItem()
- *
- * Summary:
- * Draws a themed menu item.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inMenuRect:
- * An HIRect indicating the bounds of the whole menu for which the
- * menu item is to be drawn.
- *
- * inItemRect:
- * An HIRect for the bounds of the menu item to be drawn.
- *
- * inItemDrawInfo:
- * An HIThemeMenuItemDrawInfo describing the drawing
- * characteristics of the menu item to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * outContentRect:
- * An HIRect that will be filled with the rectangle describing
- * where the menu item content is to be drawn.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawMenuItem( const (*var*) inMenuRect: HIRect; const (*var*) inItemRect: HIRect; const (*var*) inItemDrawInfo: HIThemeMenuItemDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation; var outContentRect: HIRect ): OSStatus; external name '_HIThemeDrawMenuItem';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawMenuSeparator()
- *
- * Summary:
- * Draws a themed menu separator.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inMenuRect:
- * An HIRect indicating the bounds of the whole menu for which the
- * menu separator is to be drawn.
- *
- * inItemRect:
- * An HIRect for the bounds of the menu separator to be drawn.
- *
- * inItemDrawInfo:
- * An HIThemeMenuItemDrawInfo describing the drawing
- * characteristics of the menu item to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawMenuSeparator( const (*var*) inMenuRect: HIRect; const (*var*) inItemRect: HIRect; const (*var*) inItemDrawInfo: HIThemeMenuItemDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawMenuSeparator';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetMenuBackgroundShape()
- *
- * Summary:
- * Gets the shape of the background for a themed menu.
- *
- * Discussion:
- * This shape can extend outside of the bounds of the specified
- * rectangle.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inMenuRect:
- * An HIRect indicating the bounds of the menu for which the menu
- * background is to be drawn.
- *
- * inMenuDrawInfo:
- * An HIThemeMenuDrawInfo describing the menu to be measured.
- *
- * outShape:
- * A valid HIShape that will be cleared and filled with the shape
- * of the menu background.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetMenuBackgroundShape( const (*var*) inMenuRect: HIRect; const (*var*) inMenuDrawInfo: HIThemeMenuDrawInfo; var outShape: HIShapeRef ): OSStatus; external name '_HIThemeGetMenuBackgroundShape';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- { -------------------------------------------------------------------------- }
- { Segments }
- { -------------------------------------------------------------------------- }
- {
- * Summary:
- * Available values for HIThemeSegmentPosition. These are positions
- * of the segments within the segmented view.
- }
- const
- {
- * The first position of a segmented view.
- }
- kHIThemeSegmentPositionFirst = 0;
- {
- * A middle segment.
- }
- kHIThemeSegmentPositionMiddle = 1;
- {
- * The last position of a segmented view.
- }
- kHIThemeSegmentPositionLast = 2;
- {
- * The only position of a segmented view. It is simultaneously first
- * and last. You know, only. There is only one segment. It looks
- * pretty much like a button. Please don't use this if you can avoid
- * it. It's ugly.
- }
- kHIThemeSegmentPositionOnly = 3;
- type
- HIThemeSegmentPosition = UInt32;
- {
- * Summary:
- * Available values for HIThemeSegmentKind.
- }
- const
- {
- * The outset looking segment. Do not use on metal or metal-like
- * windows.
- }
- kHIThemeSegmentKindNormal = 0;
- {
- * The inset segment. Use on metal or metal-like windows.
- }
- kHIThemeSegmentKindInset = 1;
- type
- HIThemeSegmentKind = UInt32;
- {
- * Summary:
- * Available values for HIThemeSegmentSize.
- }
- const
- {
- * The normally sized segment.
- }
- kHIThemeSegmentSizeNormal = 0;
- {
- * The small segment. Not available with as inset.
- }
- kHIThemeSegmentSizeSmall = 1;
- {
- * The mini segment. Not available with as inset.
- }
- kHIThemeSegmentSizeMini = 3;
- type
- HIThemeSegmentSize = UInt32;
- const
- {
- * No segment adornments are to be drawn.
- }
- kHIThemeSegmentAdornmentNone = 0;
- {
- * A focus ring is to be drawn around the segment.
- }
- kHIThemeSegmentAdornmentFocus = 1 shl 2; { to match button focus adornment }
- {
- * If available, a leading separator is to be drawn on the segment.
- * Note that segments overlap and if the separators are drawn over
- * top each other, the shadows multiply undesirably.
- }
- kHIThemeSegmentAdornmentLeadingSeparator = 1 shl 3;
- {
- * If available, a trailing separator is to be drawn on the segment.
- * Note that segments overlap and if the separators are drawn over
- * top each other, the shadows multiply undesirably.
- }
- kHIThemeSegmentAdornmentTrailingSeparator = 1 shl 4;
- type
- HIThemeSegmentAdornment = UInt32;
- {
- * HIThemeSegmentDrawInfo
- *
- * Summary:
- * Drawing parameters passed to segment drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.4.
- }
- type
- HIThemeSegmentDrawInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32;
- {
- * The ThemeDrawState for the segment to be drawn or measured.
- }
- state: ThemeDrawState;
- {
- * The ThemeButtonValue of the segment to be drawn or measured.
- }
- value: ThemeButtonValue;
- size: HIThemeSegmentSize;
- {
- * The HIThemeSegmentKind of the segment to be drawn or measured.
- }
- kind: HIThemeSegmentKind;
- {
- * The HIThemeSegmentPositions of the segment to be drawn or measured.
- }
- position: HIThemeSegmentPosition;
- {
- * The HIThemeSegmentAdornment of the segment to be drawn or measured.
- }
- adornment: HIThemeSegmentAdornment;
- end;
- HIThemeSegmentDrawInfoPtr = ^HIThemeSegmentDrawInfo;
- {
- * HIThemeDrawSegment()
- *
- * Summary:
- * Draw a piece of a segmented view.
- *
- * Discussion:
- * New in Mac OS X 10.4. Please note that segments can draw a
- * separator outside of the specified bounds and the adornments of
- * the individual segments must coordinate their drawing of
- * separators (with the adornment field of the passed in
- * HIThemeSegmentDrawInfo) to avoid overdrawing.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * The bounds of the segment to be drawn.
- *
- * inDrawInfo:
- * A HIThemeSegmentDrawInfo describing the segment to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.4 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawSegment( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemeSegmentDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawSegment';
- (* AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER *)
- { -------------------------------------------------------------------------- }
- { Tabs }
- { -------------------------------------------------------------------------- }
- {
- * HIThemeDrawTabPane()
- *
- * Summary:
- * Draws a themed tab pane.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw the pane.
- *
- * inDrawInfo:
- * The HIThemeTabPaneDrawInfo of the tab pane to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawTabPane( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeTabPaneDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawTabPane';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawTab()
- *
- * Summary:
- * Draw a themed tab.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * An HIThemeTabDrawInfo describing the tab to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * outLabelRect:
- * An HIRect into which to put the bounds of the label rect.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawTab( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeTabDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation; outLabelRect: HIRectPtr { can be NULL } ): OSStatus; external name '_HIThemeDrawTab';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTabPaneDrawShape()
- *
- * Summary:
- * Gets the shape of the draw area relative to the full bounds of
- * the tab+pane.
- *
- * Discussion:
- * This API was mistakenly named as a "Get" API. It behaves as
- * "Copy" API. THE CALLER IS RESPONSIBLE FOR RELEASING THE RETURNED
- * SHAPE.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect for which to get the shape.
- *
- * inDirection:
- * A ThemeTabDirection describing on which side of the pane the
- * tabs will be drawn.
- *
- * inTabSize:
- * An HIThemeTabSize indicating what size of tab pane to draw.
- *
- * outShape:
- * A pointer to an HIShapeRef which will be set to the shape of
- * the draw area. Needs to be released by caller.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTabPaneDrawShape( const (*var*) inRect: HIRect; inDirection: ThemeTabDirection; inTabSize: HIThemeTabSize; var outShape: HIShapeRef ): OSStatus; external name '_HIThemeGetTabPaneDrawShape';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTabPaneContentShape()
- *
- * Summary:
- * Gets the shape of the content area relative to the full bounds of
- * the tab+pane.
- *
- * Discussion:
- * This API was mistakenly named as a "Get" API. It behaves as
- * "Copy" API. THE CALLER IS RESPONSIBLE FOR RELEASING THE RETURNED
- * SHAPE.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect for which to get the shape.
- *
- * inDirection:
- * A ThemeTabDirection describing on which side of the pane the
- * tabs will be drawn.
- *
- * inTabSize:
- * An HIThemeTabSize indicating what size of tab pane to draw.
- *
- * outShape:
- * A pointer to an HIShapeRef which will be set to the shape of
- * the draw content. Needs to be released by caller.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTabPaneContentShape( const (*var*) inRect: HIRect; inDirection: ThemeTabDirection; inTabSize: HIThemeTabSize; var outShape: HIShapeRef ): OSStatus; external name '_HIThemeGetTabPaneContentShape';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTabDrawShape()
- *
- * Summary:
- * Gets the shape of the tab drawing area relative to the full
- * bounds of the tab+pane.
- *
- * Discussion:
- * This API was mistakenly named as a "Get" API. It behaves as
- * "Copy" API. THE CALLER IS RESPONSIBLE FOR RELEASING THE RETURNED
- * SHAPE.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect for which to get the shape.
- *
- * inDrawInfo:
- * An HIThemeTabDrawInfo describing the tab that will be drawn.
- *
- * outShape:
- * A pointer to an HIShapeRef which will be set to the shape of
- * the tab drawing area. Needs to be released by caller.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTabDrawShape( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeTabDrawInfo; var outShape: HIShapeRef ): OSStatus; external name '_HIThemeGetTabDrawShape';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTabShape()
- *
- * Summary:
- * Gets the shape for a themed tab.
- *
- * Discussion:
- * This API was mistakenly named as a "Get" API. It behaves as
- * "Copy" API. THE CALLER IS RESPONSIBLE FOR RELEASING THE RETURNED
- * SHAPE.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * An HIRect indicating the entire tabs area for which the tab
- * shape is to be retrieved.
- *
- * inDrawInfo:
- * An HIThemeTabDrawInfo describing the tab that will be drawn.
- *
- * outShape:
- * A pointer to an HIShapeRef which will be set to the shape of
- * the tab. Needs to be released by caller.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTabShape( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeTabDrawInfo; var outShape: HIShapeRef ): OSStatus; external name '_HIThemeGetTabShape';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- { -------------------------------------------------------------------------- }
- { Text }
- { -------------------------------------------------------------------------- }
- const
- {
- * Don't truncate the measured or drawn text.
- }
- kHIThemeTextTruncationNone = 0;
- {
- * During measure or draw, if the text will not fit within the
- * available bounds, truncate the text in the middle of the last
- * visible line.
- }
- kHIThemeTextTruncationMiddle = 1;
- {
- * During measure or draw, if the text will not fit within the
- * available bounds, truncate the text at the end of the last visible
- * line.
- }
- kHIThemeTextTruncationEnd = 2;
- type
- HIThemeTextTruncation = UInt32;
- const
- {
- * The text will be drawn flush with the left side of the bounding
- * box.
- }
- kHIThemeTextHorizontalFlushLeft = 0;
- {
- * The text will be centered within the bounding box.
- }
- kHIThemeTextHorizontalFlushCenter = 1;
- {
- * The text will be drawn flush with the right side of the bounding
- * box.
- }
- kHIThemeTextHorizontalFlushRight = 2;
- type
- HIThemeTextHorizontalFlush = UInt32;
- const
- {
- * Draw the text vertically flush with the top of the box
- }
- kHIThemeTextVerticalFlushTop = 0;
- {
- * Vertically center the text
- }
- kHIThemeTextVerticalFlushCenter = 1;
- {
- * Draw the text vertically flush with the bottom of the box
- }
- kHIThemeTextVerticalFlushBottom = 2;
- type
- HIThemeTextVerticalFlush = UInt32;
- const
- kHIThemeTextBoxOptionNone = 0;
- kHIThemeTextBoxOptionStronglyVertical = 1 shl 1;
- type
- HIThemeTextBoxOptions = OptionBits;
- const
- kHIThemeTextInfoVersionZero = 0;
- {
- * HIThemeTextInfo
- *
- * Summary:
- * Drawing parameters passed to text drawing and measuring theme
- * APIs.
- *
- * Discussion:
- * New in Mac OS X 10.3, this structure is used for measuring and
- * drawing text with the HIThemeGetTextDimensions and
- * HIThemeDrawTextBox APIs. If truncationPosition is
- * kHIThemeTextTruncationNone, the other fields with the truncation
- * prefix are ignored.
- }
- type
- HIThemeTextInfo = record
- {
- * The version of this data structure. Currently, it is always 0.
- }
- version: UInt32; { current version is 0 }
- {
- * The theme draw state in which to draw the string.
- }
- state: ThemeDrawState;
- {
- * The font in which to draw the string.
- }
- fontID: ThemeFontID;
- {
- * The horizontal flushness of the text. One of the
- * kHIThemeTextHorizontalFlush[Left/Center/Right] constants. When
- * this structure is used for HIThemeGetTextDimensions, this field
- * has no effect on the returned dimensions. However, providing the
- * same flushness that will be used with a subsequent draw will
- * trigger a performance optimization.
- }
- horizontalFlushness: HIThemeTextHorizontalFlush; { kHIThemeTextHorizontalFlush[Left/Center/Right] }
- {
- * The vertical flushness of the text. One of the
- * kHIThemeTextVerticalFlush[Top/Center/Bottom] constants. When this
- * paramblock is used for HIThemeGetTextDimensions, this field has no
- * effect on the returned dimensions. However, providing the same
- * flushness that will be used with a subsequent draw will trigger a
- * performance optimization.
- }
- verticalFlushness: HIThemeTextVerticalFlush; { kHIThemeTextVerticalFlush[Top/Center/Bottom] }
- {
- * Currently, the only option available is for strongly vertical text
- * with the kThemeTextBoxOptionStronglyVertical option bit.
- }
- options: HIThemeTextBoxOptions; { includes kHIThemeTextBoxOptionStronglyVertical }
- {
- * Specifies where truncation should occur. If this field is
- * kHIThemeTruncationNone, no truncation will occur, and all fields
- * with the truncation prefix will be ignored.
- }
- truncationPosition: HIThemeTextTruncation; { kHIThemeTextTruncation[None/Middle/End], If none the following field is ignored }
- {
- * The maximum number of lines to measure or draw before truncation
- * occurs. Ignored if truncationPosition is kHIThemeTruncationNone.
- }
- truncationMaxLines: UInt32; { the maximum number of lines before truncation occurs }
- {
- * On output, if the text has been truncated, this is set to true. If
- * the text fit completely within the parameters specified and the
- * text was not truncated, this is set to false.
- }
- truncationHappened: Boolean; { on output, whether truncation needed to happen }
- end;
- HIThemeTextInfoPtr = ^HIThemeTextInfo;
- {
- * HIThemeGetTextDimensions()
- *
- * Summary:
- * Get text dimensions of a string
- *
- * Discussion:
- * This allows you to get various dimension characteristics of a
- * string bound to certain criteria that you specify. It allows you
- * to get the absolute bounds of a string laid out in a single line,
- * or the bounds of a string constrained to a given width.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inString:
- * A CFStringRef containing the unicode characters you wish to
- * measure. You MUST NOT pass in a CFStringRef that was allocated
- * with any of the "NoCopy" CFString creation APIs; a string
- * created with a "NoCopy" API has transient storage which is
- * incompatible with HIThemeGetTextDimensions's caches.
- *
- * inWidth:
- * The width to constrain the text before wrapping. If inWidth is
- * 0, the text will not wrap and will be laid out as a single
- * line, unless it contains embedded carriage return or linefeed
- * characters; CR/LF will cause the text to wrap and the resulting
- * measurements will include space for multiple lines of text. If
- * inWidth is not 0, the text will wrap at the given width and the
- * measurements will be returned from the multi-line layout.
- *
- *
- * To force single-line layout even in the presence of embedded
- * CR/LF characters, pass FLT_MAX for inWidth,
- * kHIThemeTextTruncationEnd for inTextInfo.truncationPosition,
- * and 1 for inTextInfo.truncationMaxLines.
- *
- * inTextInfo:
- * The HIThemeTextInfo parameter block specifying additional
- * options for flushness and truncation. The truncationHappened
- * field is the only field that will be written to by this API
- * (and the reason for inTextInfo not being const).
- *
- * outWidth:
- * On output, will contain the width of the string. This width may
- * be smaller than the constrain inWidth parameter if the text has
- * wrapped. It will return the true bounding width of the layout.
- * Can be NULL.
- *
- * outHeight:
- * On output, will contain the height of the string. Can be NULL.
- *
- * outBaseline:
- * On output, will contain the baseline of the string. This is the
- * delta from the top of the text to the baseline of the first
- * line. Can be NULL.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTextDimensions( inString: CFStringRef; inWidth: Float32; var inTextInfo: HIThemeTextInfo; outWidth: Float32Ptr { can be NULL }; outHeight: Float32Ptr { can be NULL }; outBaseline: Float32Ptr { can be NULL } ): OSStatus; external name '_HIThemeGetTextDimensions';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawTextBox()
- *
- * Summary:
- * Draw the string into the given bounding box
- *
- * Discussion:
- * Draw the string into the bounding box given. You can specify
- * options such as truncation and justification as well as
- * determining whether the text was truncated when it was drawn.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inString:
- * A CFStringRef containing the unicode characters you wish to
- * render. You MUST NOT pass in a CFStringRef that was allocated
- * with any of the "NoCopy" CFString creation APIs; a string
- * created with a "NoCopy" API has transient storage which is
- * incompatible with HIThemeDrawTextBox's caches.
- *
- * inBounds:
- * The HIRect that bounds where the text is to be drawn
- *
- * inTextInfo:
- * The HIThemeTextInfo parameter block specifying additional
- * options for truncation and flushness. You can control the
- * number of lines drawn by specifying a truncation of
- * kHIThemeTextTruncationMiddle or kHIThemeTextTruncationEnd for
- * the truncationPosition field and then specifying a maximum
- * number of lines to draw before truncation occurs in the
- * truncationMaxLines field. The truncationHappened field is the
- * only field that will be written to by this API (and the reason
- * for inTextInfo not being const).
- *
- * inContext:
- * The CGContextRef into which to draw the text.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawTextBox( inString: CFStringRef; const (*var*) inBounds: HIRect; var inTextInfo: HIThemeTextInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawTextBox';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- { -------------------------------------------------------------------------- }
- { Tracks }
- { -------------------------------------------------------------------------- }
- {
- * HIThemeDrawTrack()
- *
- * Summary:
- * Draw a themed track item.
- *
- * Discussion:
- * Used to draw any tracked element including sliders and scroll
- * bars.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * An HIThemeTrackDrawInfo describing the track that will be drawn.
- *
- * inGhostRect:
- * An HIRect describing the location of the ghost indicator to be
- * drawn. Generally, this should be NULL and the control using
- * this primitive should support live feeback.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawTrack( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; {const} inGhostRect: HIRectPtr { can be NULL }; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawTrack';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawTrackTickMarks()
- *
- * Summary:
- * Draws the tick marks for a slider track.
- *
- * Discussion:
- * This primitive only draws evenly distributed tick marks.
- * Internally, it calls HIThemeDrawTickMark to do the actual tick
- * mark drawing, and any custom (non-even distribution) drawing of
- * tick marks should be done with HIThemeDrawTickMark.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * An HIThemeTrackDrawInfo describing the track tick marks that
- * will be drawn.
- *
- * inNumTicks:
- * A value indicating the number of tick marks to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawTrackTickMarks( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; inNumTicks: ItemCount; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawTrackTickMarks';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawTickMark()
- *
- * Summary:
- * Draws a single tick mark.
- *
- * Discussion:
- * This primitive draws a single tick mark and can be used to draw
- * custom tick marks that are not easily drawn by
- * HIThemeDrawTrackTickMarks, which only draws evenly distributed
- * tick marks.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * The HIThemeTickMarkDrawInfo of the tick mark to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawTickMark( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemeTickMarkDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawTickMark';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTrackThumbShape()
- *
- * Summary:
- * Get the thumb shape of a themed track.
- *
- * Discussion:
- * This API was mistakenly named as a "Get" API. It behaves as
- * "Copy" API. THE CALLER IS RESPONSIBLE FOR RELEASING THE RETURNED
- * SHAPE.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * An HIThemeTrackDrawInfo describing the track to be measured.
- *
- * outThumbShape:
- * A pointer to an HIShapeRef which will be set to the shape of
- * the themed track's thumb. Needs to be released by caller.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTrackThumbShape( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; var outThumbShape: HIShapeRef ): OSStatus; external name '_HIThemeGetTrackThumbShape';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeHitTestTrack()
- *
- * Summary:
- * Hit test the themed track.
- *
- * Discussion:
- * Returns true if the track was hit and fills in outPartHit.
- * Otherwise, returns false.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * An HIThemeTabDrawInfo describing the tab that will be drawn.
- *
- * inMousePoint:
- * An HIPoint which will be location basis for the test.
- *
- * outPartHit:
- * A pointer to a ControlPartCode that will be filled with the
- * part hit by the incoming point.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeHitTestTrack( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; const (*var*) inMousePoint: HIPoint; var outPartHit: ControlPartCode ): Boolean; external name '_HIThemeHitTestTrack';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTrackBounds()
- *
- * Summary:
- * Gets the track bounds of a themed track.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * An HIThemeTrackDrawInfo describing the track that will be drawn.
- *
- * outBounds:
- * A pointer to an HIRect in which will be returned the rectangle
- * of the track bounds.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTrackBounds( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; var outBounds: HIRect ): OSStatus; external name '_HIThemeGetTrackBounds';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTrackPartBounds()
- *
- * Summary:
- * Returns measurements for the bounds of the a track part,
- * according to the specifics of that track as specified in the
- * incoming draw info record.
- *
- * Discussion:
- * HIThemeGetTrackPartBounds allows you to get the boundaries of
- * individual pieces of a track's theme layout.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * An HIThemeTrackDrawInfo describing the track to be measured.
- *
- * inPartCode:
- * A ControlPartCode describing which part to measure. A list of
- * available ControlPartCodes can be retrieved using
- * HIThemeGetTrackParts.
- *
- * outPartBounds:
- * The bounds of the specified part relative to the start
- * rectangle specified in inDrawInfo.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTrackPartBounds( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; inPartCode: ControlPartCode; var outPartBounds: HIRect ): OSStatus; external name '_HIThemeGetTrackPartBounds';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTrackParts()
- *
- * Summary:
- * Counts the number of parts that make up a track. Optionally
- * returns an array of ControlPartCodes that describe each of the
- * counted parts.
- *
- * Discussion:
- * HIThemeGetTrackParts allows you to count the number of parts that
- * make up a track. This is useful if you need to iterate through
- * the parts of a track and get information about them, i.e. using
- * HIThemeGetTrackPartBounds.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * An HIThemeTrackDrawInfo describing the track to be measured.
- *
- * outNumberOfParts:
- * A pointer to a UInt32 in which to return the number of counted
- * parts.
- *
- * inMaxParts:
- * The maximum number of ControlPartCodes that can be copied into
- * the supplied ioPartsBuffer. This value is ignored if
- * ioPartsBuffer is NULL.
- *
- * ioPartsBuffer:
- * An pointer to an array into which HIThemeGetTrackPartBounds
- * will copy ControlPartCodes that describe each of the counted
- * parts. This pointer can be NULL if you are just counting parts.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTrackParts( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; var outNumberOfParts: UInt32; inMaxParts: UInt32; ioPartsBuffer: ControlPartCodePtr { can be NULL } ): OSStatus; external name '_HIThemeGetTrackParts';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTrackDragRect()
- *
- * Summary:
- * Get the rectangle of the drag area of a themed track.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * An HIThemeTrackDrawInfo describing the track to be measured.
- *
- * outDragRect:
- * A pointer to an HIRect in which will be returned the rectangle
- * of the drag area of the track.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTrackDragRect( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; var outDragRect: HIRect ): OSStatus; external name '_HIThemeGetTrackDragRect';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTrackThumbPositionFromOffset()
- *
- * Summary:
- * Get the track's relative thumb position based on the offset.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * An HIThemeTrackDrawInfo describing the track to be measured.
- *
- * inThumbOffset:
- * An HIPoint describing the position of the thumb as an offset
- * from the track bounds.
- *
- * outRelativePosition:
- * On output, the track-relative position calculated from the
- * thumb offset.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTrackThumbPositionFromOffset( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; const (*var*) inThumbOffset: HIPoint; var outRelativePosition: Float32 ): OSStatus; external name '_HIThemeGetTrackThumbPositionFromOffset';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTrackThumbPositionFromBounds()
- *
- * Summary:
- * Get the themed track thumb position from its bounds.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * A pointer to an HIThemeTrackDrawInfo describing the track to be
- * measured.
- *
- * inThumbBounds:
- * The bounds of the thumb from which the postion is to be
- * calculated.
- *
- * outRelativePosition:
- * On output, the track-relative position calculated from the
- * thumb location.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTrackThumbPositionFromBounds( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; const (*var*) inThumbBounds: HIRect; var outRelativePosition: Float32 ): OSStatus; external name '_HIThemeGetTrackThumbPositionFromBounds';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetTrackLiveValue()
- *
- * Summary:
- * Get the themed track live value.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inDrawInfo:
- * An HIThemeTrackDrawInfo describing the track to be measured.
- *
- * inRelativePosition:
- * An HIPoint describing the position of the thumb as an offset
- * from the track bounds.
- *
- * outValue:
- * On output, the track value as calculated from the relative
- * postion of the thumb.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetTrackLiveValue( const (*var*) inDrawInfo: HIThemeTrackDrawInfo; inRelativePosition: Float32; var outValue: SInt32 ): OSStatus; external name '_HIThemeGetTrackLiveValue';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetScrollBarTrackRect()
- *
- * Summary:
- * Gets the rectangle of the tracking area of a themed scroll bar.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * An HIRect indicating the area in which the scroll bar will be
- * drawn.
- *
- * inTrackInfo:
- * An HIScrollBarTrackInfo for the scroll bar to be drawn.
- * Currently, only the pressState and enableState fields are used.
- *
- * inIsHoriz:
- * A Boolean where true means that the scroll bar is to be
- * horizontal and false means that the scroll bar is to be
- * vertical.
- *
- * outTrackBounds:
- * A pointer to an HIRect in which will be returned the rectangle
- * of the track area of the scroll bar.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetScrollBarTrackRect( const (*var*) inBounds: HIRect; const (*var*) inTrackInfo: HIScrollBarTrackInfo; inIsHoriz: Boolean; var outTrackBounds: HIRect ): OSStatus; external name '_HIThemeGetScrollBarTrackRect';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeHitTestScrollBarArrows()
- *
- * Summary:
- * Hit test the theme scroll bar arrows to determine where the hit
- * occurred.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inScrollBarBounds:
- * An HIRect indicating the bounds of the scroll bar that will be
- * hit tested.
- *
- * inTrackInfo:
- * An HIScrollBarTrackInfo for the scroll bar to be drawn.
- * Currently, only the version, pressState and enableState fields
- * are used.
- *
- * inIsHoriz:
- * A Boolean where true means that the scroll bar is to be
- * horizontal and false means that the scroll bar is to be
- * vertical.
- *
- * inPtHit:
- * An HIPoint indicating where the control was hit and which will
- * be used for hit testing.
- *
- * outTrackBounds:
- * A pointer to an HIRect in which will be returned the rectangle
- * of the track area of the scroll bar. Can be NULL.
- *
- * outPartCode:
- * A pointer to a ControlPartCode in which the part code of the
- * hit part will be returned.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeHitTestScrollBarArrows( const (*var*) inScrollBarBounds: HIRect; const (*var*) inTrackInfo: HIScrollBarTrackInfo; inIsHoriz: Boolean; const (*var*) inPtHit: HIPoint; outTrackBounds: HIRectPtr { can be NULL }; var outPartCode: ControlPartCode ): Boolean; external name '_HIThemeHitTestScrollBarArrows';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawScrollBarDelimiters()
- *
- * Summary:
- * Draw themed scroll bar delimiters.
- *
- * Discussion:
- * Draws the grow lines delimiting the scroll bar areas. Does not
- * draw the size box.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inContRect:
- * An HIRect indicating the rectangle of the content area of the
- * window to be drawn.
- *
- * inDrawInfo:
- * The HIThemeScrollBarDelimitersDrawInfo of the delimiters to be
- * drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawScrollBarDelimiters( const (*var*) inContRect: HIRect; const (*var*) inDrawInfo: HIThemeScrollBarDelimitersDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawScrollBarDelimiters';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- { -------------------------------------------------------------------------- }
- { Windows }
- { -------------------------------------------------------------------------- }
- {
- * HIThemeDrawWindowFrame()
- *
- * Summary:
- * Draws a themed window frame.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inContRect:
- * An HIRect indicating the rectangle of the content area of the
- * window to be drawn.
- *
- * inDrawInfo:
- * The HIThemeWindowDrawInfo of the window frame to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * outTitleRect:
- * A pointer to an HIRect into which to put the bounds of the
- * title rect.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawWindowFrame( const (*var*) inContRect: HIRect; const (*var*) inDrawInfo: HIThemeWindowDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation; outTitleRect: HIRectPtr { can be NULL } ): OSStatus; external name '_HIThemeDrawWindowFrame';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawTitleBarWidget()
- *
- * Summary:
- * Draws the requested theme title bar widget.
- *
- * Discussion:
- * HIThemeDrawTitleBarWidget renders the requested theme title bar
- * widget in the proper location of a window. A common
- * misconception when using this API is that the client must specify
- * the exact location of the widget in the window. The widget will
- * locate itself in the window based relative to the content rect
- * passed in content rectangle -- the contRect parameter. Another
- * common problem is to ignore the window's attributes. The
- * attributes must be set up properly to describe the window for
- * which the widget is to be drawn.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inContRect:
- * A rectangle describing the window's content area. The widget
- * is drawn relative to the content rectangle of the window, so
- * this parameter does not describe the actual widget bounds, it
- * describes the window's content rectangle.
- *
- * inDrawInfo:
- * The HIThemeWindowWidgetDrawInfo of the window widget to be
- * drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawTitleBarWidget( const (*var*) inContRect: HIRect; const (*var*) inDrawInfo: HIThemeWindowWidgetDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawTitleBarWidget';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawGrowBox()
- *
- * Summary:
- * Draws a theme grow box.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inOrigin:
- * The origin from which to draw the grow box.
- *
- * inDrawInfo:
- * An HIThemeGrowBoxDrawInfo describing the grow box to be drawn
- * or measured.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawGrowBox( const (*var*) inOrigin: HIPoint; const (*var*) inDrawInfo: HIThemeGrowBoxDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawGrowBox';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetGrowBoxBounds()
- *
- * Summary:
- * Gets the bounds for a grow box.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inOrigin:
- * The origin from which to draw the grow box.
- *
- * inDrawInfo:
- * An HIThemeGrowBoxDrawInfo describing the grow box to be drawn
- * or measured. The state field is ignored.
- *
- * outBounds:
- * A pointer to an HIRect in which will be returned the rectangle
- * of the standalone grow box bounds.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetGrowBoxBounds( const (*var*) inOrigin: HIPoint; const (*var*) inDrawInfo: HIThemeGrowBoxDrawInfo; var outBounds: HIRect ): OSStatus; external name '_HIThemeGetGrowBoxBounds';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetWindowShape()
- *
- * Summary:
- * Obtains the specified window shape.
- *
- * Discussion:
- * This API was mistakenly named as a "Get" API. It behaves as
- * "Copy" API. THE CALLER IS RESPONSIBLE FOR RELEASING THE RETURNED
- * SHAPE.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inContRect:
- * An HIRect indicating the rectangle of the content area of the
- * window to be drawn.
- *
- * inDrawInfo:
- * The HIThemeWindowDrawInfo of the window frame to be measured.
- *
- * inWinRegion:
- * A WindowRegionCode indicating the desired region for which to
- * return the shape.
- *
- * outShape:
- * A pointer to an HIShapeRef which will be set to the shape of
- * the requested window region. Needs to be released by caller.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetWindowShape( const (*var*) inContRect: HIRect; const (*var*) inDrawInfo: HIThemeWindowDrawInfo; inWinRegion: WindowRegionCode; var outShape: HIShapeRef ): OSStatus; external name '_HIThemeGetWindowShape';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeGetWindowRegionHit()
- *
- * Summary:
- * Get the window region hit in a themed window.
- *
- * Discussion:
- * Not that this call does not return a region, but a region code.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inContRect:
- * An HIRect indicating the rectangle of the content area of the
- * window to be drawn.
- *
- * inDrawInfo:
- * The HIThemeWindowDrawInfo of the window frame to be measured.
- *
- * inPoint:
- * An HIPoint against which the test will occur.
- *
- * outRegionHit:
- * The output WindowRegionCode of hit window region.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeGetWindowRegionHit( const (*var*) inContRect: HIRect; const (*var*) inDrawInfo: HIThemeWindowDrawInfo; const (*var*) inPoint: HIPoint; var outRegionHit: WindowRegionCode ): Boolean; external name '_HIThemeGetWindowRegionHit';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- { -------------------------------------------------------------------------- }
- { Miscellaneous }
- { -------------------------------------------------------------------------- }
- {
- * HIThemeDrawFrame()
- *
- * Summary:
- * Draws a variety of frames frame.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * An HIThemeFrameDrawInfo describing the frame to be drawn or
- * measured.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawFrame( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeFrameDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawFrame';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawGroupBox()
- *
- * Summary:
- * Draws a themed primary group box.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * An HIThemeGroupBoxDrawInfo describing the group box to be drawn
- * or measured.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawGroupBox( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeGroupBoxDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawGroupBox';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawGenericWell()
- *
- * Summary:
- * Draws a themed generic well.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * An HIThemeButtonDrawInfo that describes attributes of the well
- * to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawGenericWell( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeButtonDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawGenericWell';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawPaneSplitter()
- *
- * Summary:
- * Draws a themed pane splitter.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * The HIThemeSplitterDrawInfo of the pane splitter to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawPaneSplitter( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeSplitterDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawPaneSplitter';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawGrabber()
- *
- * Summary:
- * Draws a themed grabber.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * The HIThemeGrabberDrawInfo of the grabber to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawGrabber( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeGrabberDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawGrabber';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawPlacard()
- *
- * Summary:
- * Draws a themed placard.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * The HIThemePlacardDrawInfo of the placard to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawPlacard( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemePlacardDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawPlacard';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawHeader()
- *
- * Summary:
- * Draws a themed window header in the specified rectangle.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * The HIThemeHeaderDrawInfo of the window frame to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawHeader( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeHeaderDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawHeader';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawFocusRect()
- *
- * Summary:
- * Draws a themed focus rectangle in the specified rectangle.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw.
- *
- * inHasFocus:
- * Pass in true to draw focus. Passing false effectively makes
- * this API a no-op.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawFocusRect( const (*var*) inRect: HIRect; inHasFocus: Boolean; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawFocusRect';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawSeparator()
- *
- * Summary:
- * Draw a themed separator element.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inRect:
- * The HIRect in which to draw.
- *
- * inDrawInfo:
- * The HIThemeSeparatorDrawInfo of the window frame to be drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawSeparator( const (*var*) inRect: HIRect; const (*var*) inDrawInfo: HIThemeSeparatorDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawSeparator';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeSetFill()
- *
- * Summary:
- * Set the context fill color to that specified by the requested
- * brush.
- *
- * Discussion:
- * Note that this call does not actually draw anything. It sets the
- * passed context's fill color to that of the specified theme brush.
- * Subsequent fills in the context will be with the color specified
- * by the theme brush.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBrush:
- * The ThemeBrush describing the requested fill color.
- *
- * inInfo:
- * Not used. Should always be NULL.
- *
- * inContext:
- * The CG context for which the fill color is to be set.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.4 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.4 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeSetFill( inBrush: ThemeBrush; inInfo: UnivPtr; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeSetFill';
- (* AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER *)
- {
- * HIThemeSetStroke()
- *
- * Summary:
- * Set the context stroke color to that specified by the requested
- * brush.
- *
- * Discussion:
- * Note that this call does not actually draw anything. It sets the
- * passed context's stroke color to that of the specified theme
- * brush. Subsequent strokes in the context will be with the color
- * specified by the theme brush.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBrush:
- * The ThemeBrush describing the requested stroke color.
- *
- * inInfo:
- * Not used. Should always be NULL.
- *
- * inContext:
- * The CG context for which the stroke color is to be set.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.4 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.4 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeSetStroke( inBrush: ThemeBrush; inInfo: UnivPtr; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeSetStroke';
- (* AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER *)
- {
- * HIThemeSetTextFill()
- *
- * Summary:
- * Set the context text fill color to that specified by the
- * requested brush.
- *
- * Discussion:
- * Note that this call does not actually draw anything. It sets the
- * passed context's text fill color to that of the specified
- * ThemeTextColor. Subsequent text drawing in the context will be
- * with the color specified by the ThemeTextColor.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inColor:
- * A ThemeTextColor describing the requested text fill color.
- *
- * inInfo:
- * Not used. Should always be NULL.
- *
- * inContext:
- * The CG context for which the fill color is to be set.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.4 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.4 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeSetTextFill( inColor: ThemeTextColor; inInfo: UnivPtr; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeSetTextFill';
- (* AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER *)
- {
- * HIThemeApplyBackground()
- *
- * Summary:
- * Apply a themed background for a rectangle.
- *
- * Discussion:
- * Note that this call does not actually draw anything. It sets the
- * passed context's fill color to the requested theme background.
- * Subsequent fills in the context will fill with the theme
- * background.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * An HIRect enclosing the whole background. This rectangle is
- * used to calculate the pattern phase (if there is one) of the
- * background as it is set up in the context.
- *
- * inDrawInfo:
- * An HIThemeBackgroundDrawInfo describing the background.
- *
- * inContext:
- * The CG context for which the background is to be set.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeApplyBackground( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemeBackgroundDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeApplyBackground';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeDrawBackground()
- *
- * Summary:
- * Draw a themed background for a rectangle.
- *
- * Discussion:
- * Currently, this call only works with kThemeBackgroundMetal.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBounds:
- * An HIRect indicating the bounds to fill with the background.
- * For backgrounds that need pattern continuity, such as
- * kThemeBackgroundMetal, this rectangle is the full bounds of the
- * rectangle for which the filling is to occur. If drawing a
- * sub-rectangle of that background, set the clip and draw the
- * full rectangle. This routine has been optimized to not perform
- * calculations on the non-clip part of the drawing bounds.
- *
- * inDrawInfo:
- * An HIThemeBackgroundDrawInfo describing the background to be
- * drawn.
- *
- * inContext:
- * The CG context in which the drawing is to be done.
- *
- * inOrientation:
- * An HIThemeOrientation that describes the orientation of the
- * passed in context.
- *
- * Availability:
- * Mac OS X: in version 10.3 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.3 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeDrawBackground( const (*var*) inBounds: HIRect; const (*var*) inDrawInfo: HIThemeBackgroundDrawInfo; inContext: CGContextRef; inOrientation: HIThemeOrientation ): OSStatus; external name '_HIThemeDrawBackground';
- (* AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER *)
- {
- * HIThemeBrushCreateCGColor()
- *
- * Summary:
- * Create a CGColor for a ThemeBrush.
- *
- * Discussion:
- * Color is an ambiguous term. The color may be a pattern.
- *
- * Mac OS X threading:
- * Not thread safe
- *
- * Parameters:
- *
- * inBrush:
- * The ThemeBrush describing the requested color.
- *
- * outColor:
- * A pointer to a CGColorRef that will be set to the newly created
- * CGColor.
- *
- * Result:
- * An operating system result code.
- *
- * Availability:
- * Mac OS X: in version 10.4 and later in Carbon.framework
- * CarbonLib: not available in CarbonLib 1.x, is available on Mac OS X version 10.4 and later
- * Non-Carbon CFM: not available
- }
- function HIThemeBrushCreateCGColor( inBrush: ThemeBrush; var outColor: CGColorRef ): OSStatus; external name '_HIThemeBrushCreateCGColor';
- (* AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER *)
- end.
|