com.jniwrapper.win32.shell
Interface IShellLink

All Superinterfaces:

com.jniwrapper.AutoDeleteParameter, com.jniwrapper.win32.com.IUnknown

All Known Implementing Classes:

IShellLinkImpl

public interface IShellLink
extends com.jniwrapper.win32.com.IUnknown

Represents IShellLink COM Interface This interface is used to manage folders, and exposed by all Shell namespace folder objects.

See Also:

Microsoft IShellLink Interface

Field Summary

static java.lang.String

INTERFACE_IDENTIFIER String representation of the IID of the IShellLink interface

Method Summary

com.jniwrapper.Str	getArguments(com.jniwrapper.Int cch) Returns the command-line arguments associated with a Shell link object.
com.jniwrapper.Str	getDescription(com.jniwrapper.Int cch) Returns the description string for a Shell link object.
com.jniwrapper.UInt16	getHotkey() Returns the keyboard shortcut (hot key) for a Shell link object.
void	getIconLocation(com.jniwrapper.Str pszIconPath, com.jniwrapper.Int cch, com.jniwrapper.Int piIcon) Returns the location (path and index) of the icon for a Shell link object.
ItemIDList	getIDList() Returns the list of item identifiers for a Shell link object.
void	getPath(com.jniwrapper.Str pszFile, com.jniwrapper.Int cch, Win32FindData pfd, com.jniwrapper.UInt32 fFlags) Returns the path and file name of a Shell link object.
com.jniwrapper.Int	getShowCmd() Returns the show command for a Shell link object.
com.jniwrapper.Str	getWorkingDirectory(com.jniwrapper.Int cch) Returns the name of the working directory for a Shell link object.
void	resolve(Wnd hwnd, com.jniwrapper.UInt32 fFlags) Attempts to find the target of a Shell link, even if it has been moved or renamed.
void	setArguments(com.jniwrapper.Str pszArgs) Sets the command-line arguments for a Shell link object.
void	setDescription(com.jniwrapper.Str pszName) Sets the description for a Shell link object.
void	setHotkey(com.jniwrapper.UInt16 wHotkey) Sets a keyboard shortcut (hot key) for a Shell link object.
void	setIconLocation(com.jniwrapper.Str pszIconPath, com.jniwrapper.Int iIcon) Sets the location (path and index) of the icon for a Shell link object.
void	setIDList(ItemIDList pidl) Sets the pointer to an item identifier list (PIDL) for a Shell link object
void	setPath(com.jniwrapper.Str pszFile) Sets the path and file name of a Shell link object.
void	setRelativePath(com.jniwrapper.Str pszPathRel, com.jniwrapper.UInt32 dwReserved) Sets the relative path to the Shell link object.
void	setShowCmd(com.jniwrapper.Int iShowCmd) Sets the show command for a Shell link object.
void	setWorkingDirectory(com.jniwrapper.Str pszDir) Sets the name of the working directory for a Shell link object.

Methods inherited from interface com.jniwrapper.win32.com.IUnknown

addRef, isNull, queryInterface, release, setNull

Methods inherited from interface com.jniwrapper.AutoDeleteParameter

isAutoDelete, setAutoDelete

Field Detail

INTERFACE_IDENTIFIER

static final java.lang.String INTERFACE_IDENTIFIER

String representation of the IID of the IShellLink interface

Method Detail

getPath

void getPath(com.jniwrapper.Str pszFile,
             com.jniwrapper.Int cch,
             Win32FindData pfd,
             com.jniwrapper.UInt32 fFlags)
             throws com.jniwrapper.win32.com.ComException

Returns the path and file name of a Shell link object.

Parameters:

pszFile - The string that receives the path and file name of the Shell link object.

cch - The maximum number of characters to copy to the string pointed to by the pszFile parameter.

pfd - The address of a Win32FindData class that receives information about the Shell link object. If this parameter is NULL, then no additional information is returned.

fFlags - Flags that specify the type of path information to retrieve.

Throws:

com.jniwrapper.win32.com.ComException

getIDList

ItemIDList getIDList()
                     throws com.jniwrapper.win32.com.ComException

Returns the list of item identifiers for a Shell link object.

Returns:

The list of item identifiers, represented by ItemIDList class

Throws:

com.jniwrapper.win32.com.ComException

setIDList

void setIDList(ItemIDList pidl)
               throws com.jniwrapper.win32.com.ComException

Sets the pointer to an item identifier list (PIDL) for a Shell link object

Parameters:

pidl - The list of item identifiers, represented by ItemIDList class

Throws:

com.jniwrapper.win32.com.ComException

getDescription

com.jniwrapper.Str getDescription(com.jniwrapper.Int cch)
                                  throws com.jniwrapper.win32.com.ComException

Returns the description string for a Shell link object.

Parameters:

cch - The maximum number of characters of string, which is being returned

Returns:

The description string for a Shell link object.

Throws:

com.jniwrapper.win32.com.ComException

setDescription

void setDescription(com.jniwrapper.Str pszName)
                    throws com.jniwrapper.win32.com.ComException

Sets the description for a Shell link object.

Parameters:

pszName - The description string for a Shell link object.

Throws:

com.jniwrapper.win32.com.ComException

getWorkingDirectory

com.jniwrapper.Str getWorkingDirectory(com.jniwrapper.Int cch)
                                       throws com.jniwrapper.win32.com.ComException

Returns the name of the working directory for a Shell link object.

Parameters:

cch - The maximum number of characters of string, which is being returned

Returns:

The name of the working directory for a Shell link object.

Throws:

com.jniwrapper.win32.com.ComException

setWorkingDirectory

void setWorkingDirectory(com.jniwrapper.Str pszDir)
                         throws com.jniwrapper.win32.com.ComException

Sets the name of the working directory for a Shell link object.

Parameters:

pszDir - The name of the working directory for a Shell link object.

Throws:

com.jniwrapper.win32.com.ComException

getArguments

com.jniwrapper.Str getArguments(com.jniwrapper.Int cch)
                                throws com.jniwrapper.win32.com.ComException

Returns the command-line arguments associated with a Shell link object.

Parameters:

cch - The maximum number of characters of string, which is being returned

Returns:

The command-line arguments string

Throws:

com.jniwrapper.win32.com.ComException

setArguments

void setArguments(com.jniwrapper.Str pszArgs)
                  throws com.jniwrapper.win32.com.ComException

Sets the command-line arguments for a Shell link object.

Parameters:

pszArgs - The command-line arguments string

Throws:

com.jniwrapper.win32.com.ComException

getHotkey

com.jniwrapper.UInt16 getHotkey()
                                throws com.jniwrapper.win32.com.ComException

Returns the keyboard shortcut (hot key) for a Shell link object.

Returns:

The virtual key code

Throws:

com.jniwrapper.win32.com.ComException

setHotkey

void setHotkey(com.jniwrapper.UInt16 wHotkey)
               throws com.jniwrapper.win32.com.ComException

Sets a keyboard shortcut (hot key) for a Shell link object.

Parameters:

wHotkey - The virtual key code

Throws:

com.jniwrapper.win32.com.ComException

getShowCmd

com.jniwrapper.Int getShowCmd()
                              throws com.jniwrapper.win32.com.ComException

Returns the show command for a Shell link object.

Returns:

Value, which specifies the show command

Throws:

com.jniwrapper.win32.com.ComException

setShowCmd

void setShowCmd(com.jniwrapper.Int iShowCmd)
                throws com.jniwrapper.win32.com.ComException

Sets the show command for a Shell link object. The show command sets the initial show state of the window.

Parameters:

iShowCmd - Value, which specifies the show command

Throws:

com.jniwrapper.win32.com.ComException

getIconLocation

void getIconLocation(com.jniwrapper.Str pszIconPath,
                     com.jniwrapper.Int cch,
                     com.jniwrapper.Int piIcon)
                     throws com.jniwrapper.win32.com.ComException

Returns the location (path and index) of the icon for a Shell link object.

Parameters:

pszIconPath - String that receives the path of the file containing the icon.

cch - The maximum number of characters to copy to the string pointed to by the pszIconPath parameter.

piIcon - Value that receives the index of the icon.

Throws:

com.jniwrapper.win32.com.ComException

setIconLocation

void setIconLocation(com.jniwrapper.Str pszIconPath,
                     com.jniwrapper.Int iIcon)
                     throws com.jniwrapper.win32.com.ComException

Sets the location (path and index) of the icon for a Shell link object.

Parameters:

pszIconPath - The path of the file containing the icon.

iIcon - The index of the icon.

Throws:

com.jniwrapper.win32.com.ComException

setRelativePath

void setRelativePath(com.jniwrapper.Str pszPathRel,
                     com.jniwrapper.UInt32 dwReserved)
                     throws com.jniwrapper.win32.com.ComException

Sets the relative path to the Shell link object.

Parameters:

pszPathRel - String that contains the new relative path. It should be a file name, not a folder name.

dwReserved - Reserved. Set this parameter to zero.

Throws:

com.jniwrapper.win32.com.ComException

resolve

void resolve(Wnd hwnd,
             com.jniwrapper.UInt32 fFlags)
             throws com.jniwrapper.win32.com.ComException

Attempts to find the target of a Shell link, even if it has been moved or renamed.

Parameters:

hwnd - A handle to the window that the Shell will use as the parent for a dialog box. The Shell displays the dialog box if it needs to prompt the user for more information while resolving a Shell link.

fFlags - Action flags.

Throws:

com.jniwrapper.win32.com.ComException

setPath

void setPath(com.jniwrapper.Str pszFile)
             throws com.jniwrapper.win32.com.ComException

Sets the path and file name of a Shell link object.

Parameters:

pszFile - String that contains the new path.

Throws:

com.jniwrapper.win32.com.ComException