API Reference


Items marked as deprecated have been replaced by a more powerful, alternative feature. Deprecated interfaces include a reference to the replacement interface, which should be used for all new application development. Deprecated features are still supported for backward compatibility, but should be avoided when developing new applications.
Brew Release
Brew MP 1.0.2
See Also
IResFile IResFile_GetNamedObject() IResFile_GetNamed()
This method is deprecated.
Gets a named image from a resource file. Names for a resource can be given as a variable set of, null terminated, string arguments. Each string specifies one or more levels in the naming tree. A simple string without '.' characters specifies a single level in the naming tree where as a dot separated set of names in a string specify a series of names in the naming tree.
Loading a image, for example, could look like:
      IResFile_GetNamedImage(piResFile, (void**)&piImage, "Main", "Background", "Image", 0))

or could look like:
      IResFile_GetNamedImage(piResFile, (void**)&piImage, "Main.Background.Image", 0))

or a mix of the above:
      IResFile_GetNamedImage(piResFile, (void**)&piImage, "Main", "Background.Image", 0))
  • po
    A pointer to an IResFile object.
  • ppo
    Pointer to an IImage pointer ...: null terminated string arguments (see above)

   int IRESFILE_GetNamedImage(IResFile *po, void **ppo, ...)
SUCCESS, if the named resource was found and loaded EBADSTATE, if this resource file is not open EUNSUPPORTED, if this resource file does not support named resources EUNABLETOLOAD, if the named resource could not be resolved or loaded
Side Effect
This function is a shortcut function for the interface function IResFile_GetNamedImageV which takes an actual vararg parameter.
IRESFILE_GetNamedImageV is actually a shortcut for the IResFile_GetNamedObject function with HTYPE_VIEWER.
  • Follow