]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/filetype.tex
commented and documented wxXRC_NO_RELOADING flag
[wxWidgets.git] / docs / latex / wx / filetype.tex
index 9c9db0fcc8ee07220f4350397b655bf6270a8197..15ac25a77c503c6514ab2d3ae634457bf80c4a8a 100644 (file)
@@ -7,7 +7,7 @@ object may be created in several different ways: the program might know the file
 extension and wish to find out the corresponding MIME type or, conversely, it
 might want to find the right extension for the file to which it writes the
 contents of given MIME type. Depending on how it was created some fields may be
-unknown so the return value of all the accessors {\bf must} be checked: {\tt FALSE}
+unknown so the return value of all the accessors {\bf must} be checked: {\tt false}
 will be returned if the corresponding information couldn't be found.
 
 The objects of this class are never created by the application code but are
@@ -122,7 +122,7 @@ The destructor of this class is not virtual, so it should not be derived from.
 
 \func{bool}{GetMimeType}{\param{wxString*}{ mimeType}}
 
-If the function returns {\tt TRUE}, the string pointed to by {\it mimeType} is filled
+If the function returns {\tt true}, the string pointed to by {\it mimeType} is filled
 with full MIME type specification for this file type: for example, "text/plain".
 
 \membersection{wxFileType::GetMimeTypes}\label{wxfiletypegetmimetypes}
@@ -139,23 +139,29 @@ mime.types.
 
 \func{bool}{GetExtensions}{\param{wxArrayString\&}{ extensions}}
 
-If the function returns {\tt TRUE}, the array {\it extensions} is filled
+If the function returns {\tt true}, the array {\it extensions} is filled
 with all extensions associated with this file type: for example, it may
 contain the following two elements for the MIME type "text/html" (notice the
 absence of the leading dot): "html" and "htm".
 
 {\bf Windows:} This function is currently not implemented: there is no
 (efficient) way to retrieve associated extensions from the given MIME type on
-this platform, so it will only return {\tt TRUE} if the wxFileType object was created
+this platform, so it will only return {\tt true} if the wxFileType object was created
 by \helpref{GetFileTypeFromExtension}{wxmimetypesmanagergetfiletypefromextension} 
 function in the first place.
 
 \membersection{wxFileType::GetIcon}\label{wxfiletypegeticon}
 
-\func{bool}{GetIcon}{\param{wxIcon*}{ icon}}
+\func{bool}{GetIcon}{\param{wxIconLocation *}{ iconLoc}}
 
-If the function returns {\tt TRUE}, the icon associated with this file type will be
-created and assigned to the {\it icon} parameter.
+If the function returns {\tt true}, the {\tt iconLoc} is filled with the
+location of the icon for this MIME type. A \helpref{wxIcon}{wxicon} may be
+created from {\it iconLoc} later.
+
+{\bf Windows:} The function returns the icon shown by Explorer for the files of
+the specified type.
+
+{\bf Mac:} This function is not implemented and always returns {\tt false}.
 
 {\bf Unix:} MIME manager gathers information about icons from GNOME
 and KDE settings and thus GetIcon's success depends on availability
@@ -165,7 +171,7 @@ of these desktop environments.
 
 \func{bool}{GetDescription}{\param{wxString*}{ desc}}
 
-If the function returns {\tt TRUE}, the string pointed to by {\it desc} is filled
+If the function returns {\tt true}, the string pointed to by {\it desc} is filled
 with a brief description for this file type: for example, "text document" for
 the "text/plain" MIME type.
 
@@ -175,7 +181,7 @@ the "text/plain" MIME type.
 
 \func{wxString}{GetOpenCommand}{\param{const wxString\&}{ filename}}
 
-With the first version of this method, if the {\tt TRUE} is returned, the
+With the first version of this method, if the {\tt true} is returned, the
 string pointed to by {\it command} is filled with the command which must be
 executed (see \helpref{wxExecute}{wxexecute}) in order to open the file of the
 given type. In this case, the name of the file as well as any other parameters
@@ -184,14 +190,14 @@ class.
 
 In the second case, only the filename is specified and the command to be used
 to open this kind of file is returned directly. An empty string is returned to
-indicate that an error occured (typically meaning that there is no standard way
+indicate that an error occurred (typically meaning that there is no standard way
 to open this kind of files).
 
 \membersection{wxFileType::GetPrintCommand}\label{wxfiletypegetprintcommand}
 
 \func{bool}{GetPrintCommand}{\param{wxString*}{ command},\param{MessageParameters\&}{ params}}
 
-If the function returns {\tt TRUE}, the string pointed to by {\it command} is filled
+If the function returns {\tt true}, the string pointed to by {\it command} is filled
 with the command which must be executed (see \helpref{wxExecute}{wxexecute}) in
 order to print the file of the given type. The name of the file is
 retrieved from \helpref{MessageParameters}{wxfiletypemessageparameters} class.