функции С и C++, библиотек C++Builder, API Windows________________881

Определение

HINSTANCE ShellExecute(

HWND hwnd,           // дескриптор родительского окна
LPCTSTR IpOperation, // строка выполняемой операции
LPCTSTR IpFile,      // строка с именем файла или папки
LPCTSTR IpParameters,// строка параметров выполняемого файла
LPCTSTR IpDirectory, // строка каталога по умолчаниюу
INT nShowCmd         // режим открытия файла

) ;

Описание

Функция ShellExecute позволяет выполнить любое приложение Windows. Мож-
но также открыть файл документа, что означает выполнение связанного с ним прило-
жения и загрузку в него этого документа. Например, обычно с документами, имею-
щими расширение .doc, связан Word. В этом случае открыть файл, например, с име-
нем «file. doc» означает запустить Word и передать ему в качестве параметра имя фай-
ла «file. doc». Кроме описанных возможностей функция ShellExecute позволяет рас-
печатать указанный файл или открыть указанную папку. Последнее означает, что бу-
дет запущена программа «Проводник» с открытой указанной папкой.

Параметры функции означают следующее:

Параметр	Описание
hwnd	Родительское окно, в котором отображаются сообщения запускаемого приложения.
IpOperation	Указывает на строку с нулевым символом в конце, которая определяет выполняемую операцию. Эта строка может содержать текст «open» (открыть) или «print» (напечатать). Для Windows 95, 98 и NT определено еще одно значение: «explore» (исследовать) — открыть папку. Если параметр IpOperation равен NULL, то по умолчанию выполняется операция «open».
IpFile IpParameters	Указывает на строку с нулевым символом в конце, которая определяет имя открываемого файла.Указывает на строку с нулевым символом в конце, которая определяет передаваемые в приложение параметры, если File-Name определяет выполняемый файл. Если IpFile указывает на строку, определяющую открываемый документ, то этот параметр задается равным NULL.
IpDirectory	Указывает на строку с нулевым символом в конце, которая определяет каталог по умолчанию.
nShowCmd	Определяет, режим открытия указанного файла. Этот параметр может иметь значения:
	SWHIDE	Окно делается невидимым и фокус передается другому окну
	SWJMINIMIZE	Свертывает (минимизирует) указанное окно и активизирует следующее в Z-последовательности окно верхнего уровня в списке системы
	SWMAXIMIZE	Развертывает (максимизирует) указанное окно