🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Thread View: comp.sys.mac.programmer.help
4 messages
4 total messages Started by ccorbell Wed, 07 Nov 2001 23:12
AppleHelp.h / Carbon Call from Classic
#49
Author: ccorbell
Date: Wed, 07 Nov 2001 23:12
38 lines
2557 bytes
Hi,

I have two questions I hope someone can answer - either
answer will get me where I need to go but I'm curious about both.

The first is, in general, whether it's possible to call a
CarbonLib function from a pre-Carbon CFM app under 8.6+,
either directly or through some sort of shim library.
CW7 includes many examples for crossing the Mach-o/CFM call
boundary with a Carbon app but I've never seen an example
of crossing the pre-Carbon/Carbon boundary from a pre-Carbon
app known to be running in a Carbon-enabled OS version.
Can I call CarbonLib functions if I find CarbonLib present,
even if I didn't link against it?

The second question is, what's the easiest way to support Apple
Help Viewer online help from a pre-Carbon CFM app; the
AppleHelp.h functions aren't available.  I toyed with sending
an AppleScript command to the help viewer but didn't like the
results.  There are a couple examples in the SDK & Sample Code
of using some sort of Apple Guide voodoo but the examples
all focus on populating the help menu, which I'm not
concerned about - I just need to launch specific help
URL's in the help viewer in different contexts.

My app's Classic target is for MacOS 8.1 - 9; since we
need to support 8.1 CarbonLib isn't an option.  I really
want to avoid separate executables for 8.1 & 8.6+ if
it's possible (there will already be a separate executable
for 10.x).

In pre-8.6 I use Internet Config to launch a
web browser to view html help files; from 8.6-9.x I need
to launch the Help Viewer but the only examples I've found
use the AppleHelp.h methods.  

TIA for any help!
- Christopher
Re: AppleHelp.h / Carbon Call from Classic
#50
Author: meeroh
Date: Thu, 08 Nov 2001 05:25
40 lines
2634 bytes
In article <3BE9BFD8.36D7A2C2@vernier.com>,
 ccorbell <ccorbell@vernier.com> wrote:

>The first is, in general, whether it's possible to call a
>CarbonLib function from a pre-Carbon CFM app under 8.6+,
>either directly or through some sort of shim library.

No. In order to call Carbon you must be Carbonized.

>CW7 includes many examples for crossing the Mach-o/CFM call
>boundary with a Carbon app but I've never seen an example
>of crossing the pre-Carbon/Carbon boundary from a pre-Carbon
>app known to be running in a Carbon-enabled OS version.
>Can I call CarbonLib functions if I find CarbonLib present,
>even if I didn't link against it?

No.

>The second question is, what's the easiest way to support Apple
>Help Viewer online help from a pre-Carbon CFM app; the
>AppleHelp.h functions aren't available.  I toyed with sending
>an AppleScript command to the help viewer but didn't like the
>results.  There are a couple examples in the SDK & Sample Code
>of using some sort of Apple Guide voodoo but the examples
>all focus on populating the help menu, which I'm not
>concerned about - I just need to launch specific help
>URL's in the help viewer in different contexts.
>
>In pre-8.6 I use Internet Config to launch a
>web browser to view html help files; from 8.6-9.x I need
>to launch the Help Viewer but the only examples I've found
>use the AppleHelp.h methods.  

The normal solution on older Mac OS is to lauch user's default browser 
using the InternetConfig API, rather than trying to muck with the help 
viewer. Is there a reason you insist on the help viewer?

meeroh
-- 
Hire me: <http://meeroh.org/hire.html>
Re: AppleHelp.h / Carbon Call from Classic
#51
Author: ccorbell
Date: Thu, 08 Nov 2001 18:56
26 lines
2128 bytes
meeroh wrote:
[.....]
> The normal solution on older Mac OS is to lauch user's default browser
> using the InternetConfig API, rather than trying to muck with the help
> viewer. Is there a reason you insist on the help viewer?
> 
> meeroh
> --
> Hire me: <http://meeroh.org/hire.html>

A normal browser is not a help system.  I use IC and the web browser
for pre-8.6 but that isn't a very friendly solution.  It does not provide
indexing, searching by content, etc.  Help Viewer provides all of
this, not to mention the fact that it looks nicer and more professional
to the user.  It would be a shame to waste the Help Viewer available in 
8.6-9.2, which aren't quite "older Mac OS" systems yet, especially in 
the education market which my company targets.

I think I have a solution worked out that will allow the
non-Carbon app to trigger the carbon call through a high-level
shim, but this involves an additional helper application (which
I'll probably hide in App Support).  I was just hoping this problem 
would have been handled more elegantly by someone...

Thanks for feedback,
Christopher
Re: AppleHelp.h / Carbon Call from Classic
#52
Author: meeroh
Date: Thu, 08 Nov 2001 19:49
27 lines
2302 bytes
In article <3BEAD55D.5DDA05@vernier.com>,
 ccorbell <ccorbell@vernier.com> wrote:

>A normal browser is not a help system.  I use IC and the web browser
>for pre-8.6 but that isn't a very friendly solution.  It does not provide
>indexing, searching by content, etc.  Help Viewer provides all of
>this, not to mention the fact that it looks nicer and more professional
>to the user.  It would be a shame to waste the Help Viewer available in 
>8.6-9.2, which aren't quite "older Mac OS" systems yet, especially in 
>the education market which my company targets.

Sure. That's a reasonable argument. I just wanted to know what the 
argument was.

>I think I have a solution worked out that will allow the
>non-Carbon app to trigger the carbon call through a high-level
>shim, but this involves an additional helper application (which
>I'll probably hide in App Support).  I was just hoping this problem 
>would have been handled more elegantly by someone...

That's actually a pretty neat solution, if all you need is launch the 
viewer. You won't be able to add to your help menu from the helper app, 
of course, just launch the viewer?

meeroh
-- 
Hire me: <http://meeroh.org/hire.html>
Thread Navigation

This is a paginated view of messages in the thread with full content displayed inline.

Messages are displayed in chronological order, with the original post highlighted in green.

Use pagination controls to navigate through all messages in large threads.

Back to All Threads