RUS_-_Karejev_-_Razrabotka_Windows-prilozhenij

Рис. 4.56. Готовое приложение проекта Change_Data

На диске, прилагаемом к книге, вы найдете проект Change_Data (Code\Glava4 Change_Data).

1)Вы можете также писать запросы, используя заглавные буквы, — SQL нечувствителен к регистру.

2)Перед выполнением этого запроса убедитесь в том, что вы работаете с базой данных NorthwindCS. Или используйте команду use NorthwindCS.

3)База данных Microsoft Access расположена по адресу: С(имя диска):\Program Files\Microsoft Visual Studio .NET 2003\Crystal Reports\Samples\Database\xtreme.mdb

4)Разумеется, на вашем компьютере должен быть установлен Microsoft SQL Server 2000 и запущено приложение Service Manager.

5)В MS Access таблица называется Customer, в SQL — Customers.

6)Можно также создать объект DataSet, перетащив его на форму из вкладки Data панели инструментов ToolBox

7)Имя компьютера, расположение базы данных, разумеется, могут отличаться — эти значения верны только для моего компьютера.

8)Здесь и далее листинг указан без области Windows Form Designer generated code — когда весь пользовательский интерфейс состоит из единственного элемента DataGrid, нет особого смысла описывать его.

©2003-2007 INTUIT.ru. Все права защищены.

Интернет-Университет Информационных Технологий http://www.INTUIT.ru

Создание Windows-приложений на основе Visual C#

5. Лекция: Использование библиотек кода в windows-формах: версия для печати и PDA

Службы Platform Invoke. Службы COM Interoperability. Работа службы Platform Invoke. Запуск функций WinAPI. Получение имени пользователя. Библиотека secur32.dll. Диалоговые окна. Библиотека user32.dll. Динамик компьютера. Библиотека Kernel32.dll. Анимация формы. Завершение работы Windows. Класс String Builder. Библиотеки user32.dll и GDI32. Вызов COM компонентов из управляемого кода. Генерирование сборок взаимодействия. Утилита tlbimp.exe

Для работы с данной лекцией используйте примеры.

Взаимодействиеуправляемого инеуправляемого кода

При создании приложений, использующих платформу Microsoft .NET, возникает задача применения в собственных проектах уже готовых библиотек кода, написанных на других языках. Сжатые сроки разработки и уже имеющиеся программные блоки не позволяют отказаться от готовых решений, поэтому их приходится использовать, встраивая в структуру собственных проектов.

Код, выполняющийся под управлением среды выполнения (в случае платформы .NET — среды Common Language Runtime), называется управляемым. Напротив, код, запускаемый не под управлением среды, называется неуправляемым. Примером неуправляемого кода могут служить COM-компоненты, Microsoft ActiveX интерфейсы и функции API Win32.

Microsoft .NET Framework позволяет взаимодействовать с COM-компонентами, COM+-службами, внешними типами библиотек и разными службами операционной системы. Перехват исключений различается в управляемом и неуправляемом коде.

Платформа .NET Framework предлагает две службы взаимодействия управляемого кода с неуправляемым — Platform Invoke и COM interoperability, которые используют реальные возможности проекта.

СлужбыPlatform Invoke

Службы Platform Invoke позволяют управляемому коду запускать функции неуправляемого кода, которые находятся в файлах библиотек динамической компоновки (DLL). Эти службы предоставляют механизмы обнаружения и запуска неуправляемых функций и преобразование типов данных входящих и исходящих аргументов функции. Когда управляемый код запускает функцию неуправляемого кода, локализованную в DLL-файле, службы Platform Invoke находят этот DLL файл, загружают его в оперативную память и находят адрес функции в памяти. После этого службы передают входящие аргументы функции в стек, преобразовывают данные, которые необходимо перевести, эмулируют сборку мусора и передают управление по адресу неуправляемой функции в памяти.

СлужбыCOM Interoperability

Объектная модель COM (Common Object Model) компонентов имеет некоторые существенные отличия от объектной модели компонентов .NET Framework.

Управление жизненным циклом объектов. Клиенты СОМ-объектов сами управляют этим циклом, среда CLR платформы .NET берет эту задачу на себя.

Обращение к службам и объектам. Клиенты COM-объектов узнают о функциональности службы путем опроса ее интерфейса, клиенты .NET-объектов могут получить описание функциональности, используя пространство имен Reflection.

Среда CLR перемещает объекты в памяти для улучшения производительности, обновляя ссылки этих объектов. Клиенты COM имеют постоянную ссылку на ячейки памяти, не изменяющуюся в течение всей жизни объекта.

Для преодоления этих различий CLR предлагает классы-оболочки, которые позволяют управляемым и неуправляемым клиентам думать, что они работают с объектами той же среды, что и они сами. Когда управляемый клиент вызывает неуправляемый метод, CLR создает временную оболочку RCW (Runtime Callable Wrapper). RCW абстрагирует различия между управляемым и неуправляемым кодом. CLR также создает оболочку CCW (COM Callable Wrapper) для обращения процесса, которая позволяет COMобъектам запускать методы .NET-объектов.

Обзормеханизма преобразования

Механизм преобразования определяет, какие типы данных должны быть переданы в метод и возвращены методом из управляемого в неуправляемый код и наоборот. Большинство типов данных имеют свои аналоги как в управляемом, так и в неуправляемом коде. Они не нуждаются в конвертировании при передаче из одной среды в другую. В пространстве имен System такими типами данных являются следующие:

System.Byte

System.SByte

System.Int16

System.UInt16

System.Int32

System.UInt32

System.Int64

System.IntPtr

System.UintPtr

Но есть и такие типы данных, которые имеют неоднозначное значение в управляемом и неуправляемом языках программирования. Эти типы нуждаются в конвертировании при переходе из управляемого в неуправляемый код и наоборот. Например, управляемая строка (string) имеет несколько значений в неуправляемом коде. В таблице 5.1 представлен список типов данных, которые нуждаются в конвертировании при переходе из одной среды в другую.

System.Mdarray C-style или SAFEARRAY

System.String Строка с завершающим нулем (null-terminated string) или BSTR

System.Valuetype Структура

System.Szarray C-style или SAFEARRAY

В большинстве случаев стандартные RCW и CCW, сгенерированные средой выполнения, предоставляют соответствующее преобразование типов между компонентами COM и .NET Framework. Используя атрибуты, вы можете настроить перевод из одного типа в другой.

Работа службыPlatform Invoke. ЗапускфункцийWinAPI

Наиболее часто служба Platform Invoke применяется для запуска функций WinAPI, находящихся в файлах dll. Когда служба вызывает функцию, совершаются следующие операции:

обнаружение необходимой библиотеки;

загрузка найденной библиотеки в оперативную память;

обнаружение адреса библиотеки в памяти и передача аргументов функции, с их преобразованием при необходимости; после этого Platform Invoke передает управление неуправляемой функции и ждет завершения.

Для подключения функции необходимо представить адрес библиотеки и данные о функции: название, входящие и исходящие аргументы.

Windows API — это набор функций, входящий в состав семейства операционной системы Microsoft Windows. Преимуществом использования этих функций является то, что они уже полностью готовы и не приходится тратить время на реализацию подобной функциональности. Однако с ними тяжело работать — в частности, довольно сложно отлавливать исключения, возникающие в работе приложения.

Первым шагом в запуске неуправляемой функции является объявление функции. Функция должна быть статической (static) и внешней (extern). Далее следует импорт библиотеки, содержащей эту функцию. Импортировать библиотеку нужно, используя атрибут DllImport, который находится в пространстве имен System.Runtime.InteropServices. Атрибут DllImport нуждается в названии библиотеки и может принимать один из параметров, указанных в таблице 5.2:

CallingConvention Указывает тип конвертирования аргументов, передаваемых в функцию. Значением по умолчанию является

WinAPI

PreserveSig Указывает, что сигнатура управляемого метода не должна трансформироваться в сигнатуру неуправляемого метода, который возвращает значение типа HRESULT и может иметь дополнительные аргументы в качестве возвращаемых значений Значением по умолчанию является true (сигнатура не должна трансформироваться).

SetLastError Указывает возможность использования метода GetLastError для обработки ошибок при выполнении неуправляемого метода. Значением по умолчанию является false

Аргументы, которые принадлежат к простым типам данных, такие как byte или int, Platform Invoke автоматически преобразовывает в соответствующие типы в неуправляемой платформе. В таблице 5.3 приводится соответствие типов данных в функциях WinAPI и

библиотеки .NET Framework.

LPSTR (и большинство строковых типов данных) String для входящих аргументов, StringBuilder для двусторонних аргументов

При указании библиотеки не нужно указывать путь до нее. CLR ищет библиотеку в каталоге приложения, затем в подкаталогах, в папке Windows и папке Window\System32. При указании адреса библиотеки могут возникнуть исключения — CLR проверяет только его. Например, если был указан адрес "C:\Windos\system32\someDll.dl", а у пользователя операционная система располагается на диске D — приложение работать не будет. При использовании функций WinAPI сами файлы библиотек не нужно включать в проект.

Получение именипользователя. Библиотека secur32.dll

Итак, приступим к практике. Создайте новое Windows-приложение и назовите его GetUserName. Перетаскиваем на форму из окна ToolBox кнопку и надпись. Устанавливаем следующие свойства формы и элементов управления:

В окне Solution Explorer щелкаем правой кнопкой на названии проекта и выбираем Add\Add New Item…. В появившемся окне шаблонов выбираем класс и называем его WinAPIClass.cs. Переходим в его код и добавляем пространство имен для работы с библиотеками dll и объектом StringBuilder:

using System;

using System.Runtime.InteropServices; using System.Text;

Обращаемся к библиотеке secur32.dll и создаем метод GetUserNameEx (привожу пространство имен класса полностью 11)):

namespace GetUserName

{

public class WinAPIClass

{

#region Получение имени текущего пользователя

///<summary>

///Получение имени текущего пользователя.

///</summary>

///<param name="nameFormat">Формат имени из перечисления NameFormat.</param>

///<param name="userName">Выходной параметр — имя.пользователя</param>

///<param name="userNameSize">Количество символов в имени.</param>

///<returns></returns>

//Подключение библиотеки secur32.dll [DllImport("secur32.dll", CharSet=CharSet.Auto)]

public static extern int GetUserNameEx (int nameFormat, StringBuilder userName, ref uint userNameSize);

///<summary>

///Формат имени.

///</summary>

public enum NameFormat:int

{

NameUnknown = 0, NameFullyQualifiedDN = 1, NameSamCompatible = 2, NameDisplay = 3, NameUniqueId = 6, NameCanonical = 7, NameUserPrincipal = 8, NameCanonicalEx = 9, NameServicePrincipal = 10, NameDnsDomain = 12

};

#endregion

}

}

Листинг 5.1.

Все! Класс, использующий функцию WinAPI, готов. В обработчике кнопки btnGetUserName обращаемся к созданному классу:

private void btnGetUserName_Click(object sender, System.EventArgs e)

{

StringBuilder builder = new StringBuilder(100); uint size = 100;

WinAPIClass.GetUserNameEx((int)WinAPIClass.NameFormat.NameSamCompatible, builder, ref size); lblGetUserName.Text = String.Format("Имя пользователя: {0}", builder.ToString());

}

Обратите внимание на то, что в качестве значения перечисления идет тип данных int, объект StringBuilder передается в

качестве строки и к последнему параметру добавляется ключевое слово ref, т.к. параметр передается по ссылке. Результатом запуска приложения будет определение имени текущего пользователя (рис. 5.1).

Рис. 5.1. Результат запуска приложения GetUserName

Класс WinAPIClass, в котором происходит обращение к библиотеке secur32.dll, мог быть написан на другом, C-подобном языке, в оригинале он был реализован именно на C. Интересно сравнить типы данных двух листингов объявления методов:

Метод GetUserNameEx на языке С

BOOLEAN GetUserNameEx(

EXTENDED_NAME_FORMAT

//формат имени

NameFormat,

//буфер для названия

LPTSTR lpNameBuffer,

//размер буфера для названия

PULONG nSize );

Метод GetUserNameEx на языке С#

[DllImport("secur32.dll", CharSet=CharSet.Auto)] public static extern int GetUserNameEx

(int nameFormat, StringBuilder userName, ref uint userNameSize);

Выбор типа данных может повлиять на выполнение преобразования входящих и исходящих параметров. Например, в библиотеках WinAPI тип данных long — 32-битный, в то время как в C# тип данных long — 64-битный.

На диске, прилагаемом к книге, вы найдете приложение GetUserName (Code\Glava5\GetUserName).

Диалоговые окна. Библиотека user32.dll

Всякий раз, когда мы начинаем изучать новый язык программирования, в число первых примеров входит вывод текстовой строки на экран. Операционная система Windows содержит определенное число типов диалоговых окон, с помощью которых пользователь получает уведомления о различных событиях. Создайте новое Windows-приложение и назовите его MessageBox. Располагаем на форме четыре кнопки и устанавливаем следующие свойства формы и кнопок:

Form1, форма, свойство Значение

Снова добавляем к проекту класс и называем его WinAPIClass.cs.

Листинг этого класса:

using System;

using System.Runtime.InteropServices; namespace MessageBox

{

public class WinAPIClass

{

#region Вызов диалогового окна MessageBox

///<summary>

///Вызов диалогового окна MessageBox.

///</summary>

///<param name="handle">Родительская форма окна</param>

///<param name="text">Текст окна.</param>

///<param name="title">Заголовок окна.</param>

///<param name="type">Тип окна.</param>

///<returns></returns> [DllImport("user32.dll", CharSet=CharSet.Auto)]

public static extern int MessageBox(IntPtr handle, string text, string title, uint type);

///<summary>

///Тип диалогового окна.

///</summary>

public enum MessageBoxType:int

{

///<summary>

///Три кнопки — Abort, Retry, Ignore

/// </summary> MB_ABORTRETRYIGNORE = 2,

///<summary>

///Три кнопки — Cancel, Try, Continue

///</summary>

MB_CANCELTRYCONTINUE = 6,

///<summary>

///Одна кнопка — Ok.

///</summary>

MB_OK = 0,

///<summary>

///Две кнопки — Ok, Cancel.

///</summary>

MB_OKCANCEL = 1,

///<summary>

///Две кнопки — Retry, Cancel

///</summary>

MB_RETRYCANCEL = 5,

///<summary>

///Две кнопки — Yes, No

///</summary>

MB_YESNO = 4,

///<summary>

///Три кнопки — Yes, No, Cancel

///</summary>

MB_YESNOCANCEL = 3,

///<summary>

///Иконка-восклицание

///</summary>

MB_ICONEXCLAMATION = 0x30,

///<summary>

///Иконка-предупреждение

///</summary>

MB_ICONWARNING = 0x30,

///<summary>

///Иконка-информация

///</summary>

MB_ICONINFORMATION = 0x40,

///<summary>

///Иконка-вопрос

///</summary>

MB_ICONQUESTION = 0x20,

///<summary>

///Иконка-стоп

///</summary>

MB_ICONSTOP = 0x10,

///<summary>

///Иконка-ошибка

///</summary>

MB_ICONERROR = 0x10,

}

///<summary>

///Тип возвращаемого значения.

///</summary>

public enum MessageBoxReturnType:int

{

IDABORT = 3,

IDCANCEL = 2, IDCONTINUE = 11, IDIGNORE = 5, IDNO = 7,

IDOK = 1, IDRETRY = 4, IDTRYAGAIN = 10, IDYES = 6

}

#endregion

}

}

Листинг 5.2.

В перечислении MessageBoxType приводятся различные типы стандартных окон и иконок. В обработчиках кнопок выбираем несколько вариантов окон и иконок:

private void btnABORTRETRYIGNORE_Click(object sender, System.EventArgs e)

{

//Текст сообщения

string text = "Hello World"; //Заголовок окна

string title = "From WinApi";

// Тип данных IntPtr — указатель на объект.

WinAPIClass.MessageBox(IntPtr.Zero, text, title, (uint)(WinAPIClass.MessageBoxType.MB_ABORTRETRYIGNORE | WinAPIClass.MessageBoxType.MB_ICONQUESTION));

}

private void btnYESNOCANCEL_Click(object sender, System.EventArgs e)

{

string text = "Hello World"; string title = "From WinApi";

WinAPIClass.MessageBox(IntPtr.Zero, text, title, (uint)(WinAPIClass.MessageBoxType.MB_YESNOCANCEL | WinAPIClass.MessageBoxType.MB_ICONINFORMATION));

}

private void btnOK_Click(object sender, System.EventArgs e)

{

string text = "Hello World"; string title = "From WinApi";

WinAPIClass.MessageBox(IntPtr.Zero, text, title, (uint)(WinAPIClass.MessageBoxType.MB_OK | WinAPIClass.MessageBoxType.MB_ICONSTOP));

}

private void btnYESNO_Click(object sender, System.EventArgs e)

{

string text = "Hello World"; string title = "From WinApi";

WinAPIClass.MessageBox(IntPtr.Zero, text, title, (uint)(WinAPIClass.MessageBoxType.MB_YESNO | WinAPIClass.MessageBoxType.MB_ICONEXCLAMATION));

}

Листинг 5.3.

Запускаем приложение. При нажатии на кнопки появляются соответствующие диалоговые окна (рис. 5.2).

Рис. 5.2. Результат работы приложения MessageBox

На языке С метод в обработчике будет выглядеть следующим образом (сравните преобразование типов данных!):

INT MessageBox(HWND hWnd, LPCTSTR lpText,

LPCTSTR lpCaption, UINT uType);

На диске, прилагаемом к книге, вы найдете приложение MessageBox. (Code\Glava5\MessageBox).

Динамиккомпьютера. Библиотека Kernel32.dll

При включении компьютера и загрузке операционной системы раздается сигнал из динамика на системном блоке. Режим залипания клавиш, включаемый при пятикратном нажатии клавиши Shift, также сопровождается звуковым сигналом. Этот простейший динамик не может воспроизводить сложные звуки, но его иногда можно использовать, когда необходимо обратить внимание пользователя на какое-либо событие, не будучи уверенным в том, что на его компьютере имеются звуковые колонки.

Создайте новое Windows-приложение и назовите его EasySound. Располагаем на форме семь кнопок и устанавливаем следующие свойства формы и кнопок:

Form1, форма, свойство Значение

Button4, свойство Значение

Button5, свойство Значение

Button6, свойство Значение

Button7, свойство Значение

Добавляем класс WinAPIClass:

using System;

using System.Runtime.InteropServices; namespace EasySound

{

public class WinAPIClass

{

#region Вызов сигнала

///<summary>

///Вызов сигнала.

///</summary>

///<param name="frequency">Частота сигнала в герцах. Диапазон от 37 до 32767 Гц.</param>

///<param name="duration">Продолжительность сигнала в миллисекундах.</param>

///<returns></returns>

[DllImport("Kernel32.dll")]

public static extern bool Beep (int frequency, int duration); #endregion

}

}

Листинг 5.4.

Создаем обработчики для кнопок:

private void btnDo_Click(object sender, System.EventArgs e)

{

//В скобках: первый параметр — частота, второй — продолжительность сигнала

WinAPIClass.Beep(1000, 100);

}

private void btnRe_Click(object sender, System.EventArgs e)

{

WinAPIClass.Beep(3000, 100);

}

private void btnMi_Click(object sender, System.EventArgs e)

{

WinAPIClass.Beep(5000, 100);

}

private void btnFa_Click(object sender, System.EventArgs e)

{

WinAPIClass.Beep(7000, 100);

}

private void btnSol_Click(object sender, System.EventArgs e)

{

WinAPIClass.Beep(9000, 100);

}

private void btnLya_Click(object sender, System.EventArgs e)

{

WinAPIClass.Beep(11000, 100);

}

private void btnC_Click(object sender, System.EventArgs e)

{

WinAPIClass.Beep(13000, 100);

}

Листинг 5.5.

Запускаем приложение. Я не уверен, что в музыкальном смысле создаваемые сигналы в точности идентичны своим названиям, но тем не менее определенное сходство наверняка есть (рис. 5.3).

Рис. 5.3. Приложение Easy Sound

На языке С метод в обработчике будет выглядеть следующим образом:

BOOL Beep(DWORD dwFreq, DWORD dwDuration);

На диске, прилагаемом к книге, вы найдете приложение EasySound (Code\Glava5\EasySound).

Проявлениеокна

Обычная Windows-форма тоже может быть анимирована, что иногда используется для создания заставки автозагрузочных дисков (рис. 5.4). К сожалению, возможное отсутствие библиотеки .NET Framework на компьютере пользователя делает ненадежным использование такого рода приложений, написанных на C#. Остается надеяться, что выход новой версии – Microsoft Windows Longhorn — изменит ситуацию в лучшую сторону (подробнее о распространении приложений — в лекции 9).

увеличить изображение

Рис. 5.4. Анимированная форма — заставка автозагрузочного диска

Создайте новое приложение и назовите его AnimatedWindow. Расположите на форме три кнопки и установите следующие свойства формы и кнопок:

Form1, форма, свойство Значение

Добавляем класс WinAPIClass:

using System;

using System.Runtime.InteropServices; using System.Windows.Forms;

namespace AnimatedWindow

{

public class WinAPIClass

{

#region Анимация окна

///<summary>

///Тип анимации окна. Перечисление возвращает тип данных int

///после приведения. Каждому элементу перечисления присвоено

///свое значение типа int.

///</summary>

[Flags]

public enum AnimateWindowFlags:int

{

AW_HOR_POSITIVE = 1, AW_HOR_NEGATIVE = 2, AW_VER_POSITIVE = 4, AW_VER_NEGATIVE = 8, AW_CENTER = 16, AW_HIDE = 65536, AW_ACTIVATE = 131072, AW_SLIDE = 262144, AW_BLEND = 524288

};

///<summary>

///Анимация окна.

///</summary>

///<param name="hwnd">Окно.</param>

///<param name="dwTime">Время.</param>

///<param name="dwFlags">Тип анимации. Если в неуправляемом

///коде используется перечисление, то его нужно конвертировать

///в тип данных int. </param>

///<returns></returns>

[DllImportAttribute("user32.dll",EntryPoint="AnimateWindow",SetLastError=true)] public static extern bool AnimateWindow(IntPtr hwnd,int dwTime,int dwFlags);

///<summary>

///Анимация окна.

///</summary>

///<param name="ctrl">Окно.</param>

///<param name="dwTime">Время.</param>

///<param name="Flags">Флаги.</param>

///<returns></returns>

public static bool AnimateWindow(Control ctrl,int dwTime, AnimateWindowFlags Flags)

{

return AnimateWindow(ctrl.Handle,dwTime,(int)Flags);

}

#endregion

}

}

Листинг 5.6.

Создаем обработчики кнопок:

private void btnAW_BLEND_Click(object sender, System.EventArgs e)

{

//Скрываем окно this.Hide();

//Запускаем анимацию. Второй параметр в скобках — время анимации в миллисекундах. WinAPIClass.AnimateWindow(this, 3000, WinAPIClass.AnimateWindowFlags.AW_ACTIVATE|

WinAPIClass.AnimateWindowFlags.AW_BLEND);

// Отображаем кнопки после анимации this.btnAW_BLEND.Invalidate(); this.btnHOR_AW_SLIDE.Invalidate(); this.btnCenter_AW_SLIDE.Invalidate();

}

private void btnHOR_AW_SLIDE_Click(object sender, System.EventArgs e)

{