Описание API BinaryWind Library 0.1
BinaryWind
BinaryWind
Constants
BinaryInformationUnits
Является набором read-only переменных со значениями, представляющими собой количество байт, выраженное производными бинарными единицами измерения объёма информации.
Предполагается использовать эти значения, импортировав пространство имён Constants в проект или текущий файл ("Imports BinaryWind.Constants" для Visual Basic.Net и "using BinaryWind.Constants;" для C#). Примеры дальнейшего использования: "Dim a As Integer = 2 * GiB", "a = (4 * MiB) + (128 * KiB)", "Console.WriteLine(Math.Round((fileLength \ MiB), 2).ToString & " MiB")".
Важно! Это и есть, так называемые, килобайты, мегабайты, гигабайты (а также килобиты, мегабиты, гигабиты) и прочие единицы измерения объёма информации, выраженные через степень числа 2. Существует широко распространённое заблуждение, относительно верного (согласно международным стандартам) названия этих единиц. Согласно стандартам, привычный "килобайт" называется "кибибайт" и содержит 1024 байта, а килобайт, в свою очередь, содержит 1000 байт. Например, корректное именование распространено среди производителей накопителей информации (жёстких дисков): там 1TB - это 1 000 000 000 000 байт, то есть, чуть более 931.3 гибибайт (обычно называемых "гигабайтами").
Public ReadOnly B As Long= 1
Public ReadOnly KiB As Long= 1024
Public ReadOnly MiB As Long= 1048576
Public ReadOnly GiB As Long= 1073741824
Public ReadOnly TiB As Long= 1099511627776
Public ReadOnly PiB As Long= 1125899906842624
Public ReadOnly EiB As Long= 1152921504606846976
Public ReadOnly Kibit As Long= 128
Public ReadOnly Mibit As Long= 131072
Public ReadOnly Gibit As Long= 134217728
Public ReadOnly Tibit As Long= 137438953472
Public ReadOnly Pibit As Long= 140737488355328
Public ReadOnly Eibit As Long= 144115188075855872
DecimalInformationUnits
Является набором read-only переменных со значениями, представляющими собой количество байт, выраженное производными десятичными единицами измерения объёма информации.
Важно! Эти именования корректны и соответствуют стандартам. Да, это именно килобайты, мегабайты, гигабайты и так далее. Но десятичные. Если вам нужны те же единицы, но в наиболее употребительном значении (где, например, килобайт не 1000 байт, а 1024), обратитесь к значениям из модуля BinaryInformationUnits.
Public ReadOnly B As Long= 1
Public ReadOnly kB As Long= 1000
"kB" - это не опечатка.
Public ReadOnly MB As Long= 1000000
Public ReadOnly GB As Long= 1000000000
Public ReadOnly TB As Long= 1000000000000
Public ReadOnly PB As Long= 1000000000000000
Public ReadOnly EB As Long= 1000000000000000000
Strings
Некоторые управляющие (и прочие) символы ASCII.
Public ReadOnly NullChar As Char
Управляющий символ ASCII #0.
Public ReadOnly StartOfHeading As Char
Управляющий символ ASCII #1.
Public ReadOnly StartOfText As Char
Управляющий символ ASCII #2.
Public ReadOnly EndOfText As Char
Управляющий символ ASCII #3.
Public ReadOnly EndOfTransmission As Char
Управляющий символ ASCII #4.
Public ReadOnly Enquiry As Char
Управляющий символ ASCII #5.
Public ReadOnly Acknowledgement As Char
Управляющий символ ASCII #6.
Public ReadOnly Bell As Char
Управляющий символ ASCII #7.
Public ReadOnly Backspace As Char
Управляющий символ ASCII #8.
Public ReadOnly HorizontalTab As Char
Управляющий символ ASCII #9.
Public ReadOnly LineFeed As Char
Управляющий символ ASCII #10.
Public ReadOnly VerticalTab As Char
Управляющий символ ASCII #11.
Public ReadOnly FormFeed As Char
Управляющий символ ASCII #12.
Public ReadOnly CarriageReturn As Char
Управляющий символ ASCII #13.
Public ReadOnly ShiftOut As Char
Управляющий символ ASCII #14.
Public ReadOnly ShiftIn As Char
Управляющий символ ASCII #15.
Public ReadOnly DataLinkEscape As Char
Управляющий символ ASCII #16.
Public ReadOnly DeviceControl1 As Char
Управляющий символ ASCII #17.
Public ReadOnly DeviceControl2 As Char
Управляющий символ ASCII #18.
Public ReadOnly DeviceControl3 As Char
Управляющий символ ASCII #19.
Public ReadOnly DeviceControl4 As Char
Управляющий символ ASCII #20.
Public ReadOnly NegativeAcknowledgement As Char
Управляющий символ ASCII #21.
Public ReadOnly SynchronousIdle As Char
Управляющий символ ASCII #22.
Public ReadOnly EndOfTransmission As Char
Управляющий символ ASCII #23.
Public ReadOnly Cancel As Char
Управляющий символ ASCII #24.
Public ReadOnly EndOfMedium As Char
Управляющий символ ASCII #25.
Public ReadOnly Substitute As Char
Управляющий символ ASCII #26.
Public ReadOnly Escape As Char
Управляющий символ ASCII #27.
Public ReadOnly FileSeparator As Char
Управляющий символ ASCII #28.
Public ReadOnly GroupSeparator As Char
Управляющий символ ASCII #29.
Public ReadOnly RecordSeparator As Char
Управляющий символ ASCII #30.
Public ReadOnly UnitSeparator As Char
Управляющий символ ASCII #31.
Public ReadOnly Delete As Char
Управляющий символ ASCII #127.
Public ReadOnly NewLine As Char
Символ или комбинация символов, представляющая собой переход на новую строку. Для Windows это комбинация из CarriageReturn (13) и LineFeed (10).
Time
Константы и переменные, связанные с датой и временем.
Public Const UnixEpoch As Date= #1/1/1970#
Дата начала эпохи Unix.
Extensions
Содержит элементы, относящиеся к методам-расширениям (extension methods), обычно применяемым к стандартным типам данных в .Net. Эти расширения удобнее исопользовать, импортировав пространство имён Extensions в весь проект.
AlignConstants As Integer
Перечисление констант для аргумента alignTo некоторых перегрузок методов-расширений Align().
Const Least As BinaryWind.Extensions.AlignConstants= -1
Константа, указывающая на необходимость при выравнивании выбирать меньшее из ближайших значений.
Const Most As BinaryWind.Extensions.AlignConstants= 0
Константа, указывающая на необходимость при выравнивании выбирать ближайшее значение (поведение Align() по умолчанию).
Const Nearest As BinaryWind.Extensions.AlignConstants= 1
Константа, указывающая на необходимость при выравнивании выбирать большее из ближайших значений.
Arrays
Методы-расширения, относящиеся к массивам.
Public Sub Append(Of T)(ByRef targetArray() As T, ByVal element As T)
Увеличивает размер массива targetArray() на единицу и устанавливает element последним элементом.
Примечание о производительности: не рекомендуется использовать этот метод для операций с большим числом элементов, особенно в случаях, когда возможно заранее определить их количество.
Public Function IndexesOf(Of T)(ByVal lookupArray() As T, ByVal ParamArray values() As T) As Integer()
Версия системной функции IndexOf(), позволяющая осуществлять поиск сразу нескольких значений в массиве за один вызов. Возвращает Int32-массив индексов элементов из массива values(), найденных в массиве lookupArray().
Public Sub Insert(Of T)(ByRef targetArray() As T, ByVal element As T, ByVal position As Integer)
Вставляет element в указанную позицию position массива targetArray(), сдвигая элементы от указанной позиции на один вперёд.
Примечание о производительности: не рекомендуется использовать этот метод для операций с большим числом элементов, особенно в случаях, когда возможно заранее определить их количество.
Public Function Mix(Of T)(ByVal array() As T, ByVal seed As Integer) As T()
Возвращает массив элементов из массива array(), перемешав их случайным образом.
Необязательный аргумент seed позволяет контролировать порядок перемешивания, задавая начальное значение для генератора случайных чисел.
Public Sub Remove(Of T)(ByRef targetArray() As T, ByVal index As Integer)
Сдвигает диапазон элементов в массиве targetArray() от следующего после index до последнего на один элемент ближе к началу, тем самым удаляя элемент в позиции index. Затем урезает массив на один элемент.
Примечание о производительности: не рекомендуется использовать этот метод для операций с большим числом элементов, особенно в случаях, когда возможно заранее определить их количество.
Public Function RemoveRange(Of T)(ByRef targetArray() As T, ByVal index As Integer, ByVal count As Integer)
Удаляет из массива targetArray count элементов, начиная с позиции index.
Public Sub Swap(Of T)(ByVal array() As T, ByVal index1 As Integer, ByVal index2 As Integer)
В массиве array() обменивает местами элементы на позициях index1 и index2.
Public Sub Truncate(Of T)(ByRef targetArray() As T, ByVal count As Integer)
Уменьшает размер массива targetArray() на count, таким образом удаляя из него последний элемент. Аргумент count не является обязательным. Если используется версия метода без этого параметра, то он предполагается равным 1.
Примечание о производительности: не рекомендуется использовать этот метод для операций с большим числом элементов, особенно в случаях, когда возможно заранее определить их количество.
Colors
Методы-расширения, относящиеся к работе с цветом.
Public Function Invert(ByVal color As Color) As Color
Применяется к структурам типа Color. Возвращает цвет, инвертированный по отношению к color.
Этот метод инвертирует только тон (hue) указанного цвета, не затрагивая его насыщенность (saturation) и яркость (brightness). Лучше всего подходит для тех случаев, когда требуется получить картинку с инвертированным цветом объектов. На фото синее небо станет оранжевым, а зелёная трава - фиолетовой.
Public Function Negative(ByVal color As Color) As Color
Применяется к структурам типа Color. Возвращает цвет-негатив по отношению к color.
Этот метод полностью инвертирует цвет. Применив его к изображению вы получите эффект негатива аналоговой фотографии.
Public Function ToHsb(ByVal color As Color) As BinaryWind.Graphics.HsbColor
Применяется к структурам типа Color. Преобразует структуру Color в HsbColor. Позволяет работать с цветом, используя цветовую модель HSB.
Drawing
Методы-расширения, относящиеся к работе с графикой и рисованию.
Public Function Align(...) As ...
Реализует 24 версии (перегрузки) метода Align(), применяющихся к графическим примитивам Point, PointF, Rectangle, RectangleF, Size и SizeF.
Align() возвращает значение, "подогнанное по сетке" (дискретизированное) с указанным шагом. Так, для Point необходимо указать шаг step и (необязательно) правило выравнивания alignTo. Например, для Align(New Point(4,1), 5) будет возвращено New Point(5,0), так как выровненное X=4 находится ближе к 5, а Y=1 - ближе к 0 с учётом выбранного шага сетки 5.
Перегруженные варианты функции позволяют настраивать шаг сетки отдельно по осям X и Y (stepX и stepY соответственно) и выбирать правило выравнивания (alignTo). Если alignTo не указано, то осуществляется выравнивание "к ближайшему" (Nearest) значению, как в описанном примере. Существуют также варианты Least ("к меньшему") и Most ("к большему"). То есть, Point с координатами (4,1) будет выровнен к (0,0) в случае alignTo = Least и к (5,5) в случае alignTo = Most.
FileSystem
Методы-расширения, относящиеся к работе с файловой системой и прочему вводу-выводу.
Public Function SetEndOfFile(ByVal file As System.IO.FileStream)
Применяется к объектам типа FileStream. Урезает или расширяет файл.
Результирующий размер определяется текущей позицией в файловом потоке (Stream.Position). Если он больше текущего размера файла, то размер файла увеличивается, а добавленное пространство заполняется байтами со значением 0. Если он меньше текущего размера файла, то размер файла уменьшается, при этом все данные, оказавшиеся за пределами нового размера будут утеряны.
Numeric
Методы-расширения, относящиеся к работе с числами.
Public Function Align(...) As ...
Реализует 22 версии (перегрузки) метода Align(), применяющихся к стандартным числовым типам Byte, Decimal Double, Integer, Long, SByte, Short, Single, UInteger, ULong, UShort.
Align() возвращает значение number, "подогнанное по сетке" (дискретизированное) с указанным шагом step. Например, Align(8,5) вернёт 10, т.к. в "сетке" с шагом 5 число 8 находится ближе к 10.
Существует возможность указать аргумент alignTo - Least, Nearest, Most. По умолчанию подразумевается Nearest.
Least выравняет переданное значение по наименьшему из ближайших элементов "сетки". При шаге 5 значения будут (входные и выходные соответственно): 0 - 0, 1 - 0, 4 - 0, 5 - 5, 6 - 5, 9 - 5, 10 - 10 и т.д.
Nearest выравняет переданное значение по ближайшему из соседних элементов "сетки". При шаге 5 значения будут: 0 - 0, 1 - 0, 4 - 5, 5 - 5, 6 - 5, 9 - 10, 10 - 10 и т.д.
Most выравняет переданное значение по наибольшему из ближайших элементов. При шаге 5 значения будут: 0 - 0, 1 - 5, 4 - 5, 5 - 5, 6 - 10, 9 - 10, 10 - 10 и т.д.
Objects
Методы-расширения, относящиеся к работе с объектами общего типа.
Public Function EqualsAll(ByVal first As Object, ByVal ParamArray other() As Object) As Boolean
Версия системной функции Equals(), позволяющая осуществлять сравнение сразу нескольких значений за один вызов с указанным. Возвращает True, если все объекты из массива other() равны first. В противном случае возвращает False.
Strings
Методы-расширения, относящиеся к работе со строками.
Public Function IsAfter(ByVal str As String, ByVal startIndex As Integer, ByVal substring As String) As Boolean
Применяется к String. Возвращает True, если в строке str начиная с позиции startIndex встречается подстрока substring.
Public Function IsBefore(ByVal str As String, ByVal startIndex As Integer, ByVal substring As String) As Boolean
Применяется к String. Возвращает True, если в строке str перед позицией startIndex встречается подстрока substring.
Time
Методы-расширения, относящиеся к работе с датами, временем и временными промежутками.
Public Function Align(ByVal date As Date, ByVal step As System.TimeSpan, ByVal alignTo As BinaryWind.Extensions.AlignConstants) As Date
Реализует 2 версии (перегрузки) метода Align(), применяющихся к стандартному типу Date. Дискретизирует значение date до шага step по правилу alignTo (к наименьшему, ближайшему или наибольшему).
Например, вы можете указать date = Now, step, равный TimeSpan длиной в сутки и alignTo = Least. Таким образом, с помощью Align() можно получать дату, равную началу текущего дня (сегодня, ровно в 00:00:00). Или следующего, если указать alignTo = Most.
Подробнее о поведении Align() на примерах других стандартных типов данных вы можете почитать в разделах Drawing и Numeric, где также реализован этот метод-расширение.
Forms
HProgressBar
Класс, наследующий системный System.Windows.Forms.ProgressBar, полностью совместимый с ним и расширяющий его функциональность.
Public Property State() As BinaryWind.Forms.ProgressBarStateConstants
Позволяет получать и устанавливать текущее состояние полосы прогресса в соответствии с текущей темой оформления Windows. Поддерживаются состояния: нормальное, пауза, ошибка. При стандартной схеме оформления Windows 7 этим состояниям соответствуют: зелёная анимированная полоса, жёлтая статичная полоса, красная статичная полоса.
NonWorkingAreaControlsManager
Объект, позволяющий работать с произвольными видимыми элементами управления как с частью заголовка обычного окна: перемещать окно, удерживая его с помощью мыши за указанный объект, сворачивать окно в нормальный размер и разворачивать на полный экран двойным нажатием, а также вызывать стандартное контекстное меню окна правым щелчком мыши в области указанных элементов управления.
Public Sub Add(ByVal control As Control)
Добавляет новый элемент управления в коллекцию.
Public Property AllowMaximizeRestore() As Boolean
Определяет, включена ли возможность разворачивать окно на весь экран и восстанавливать его размер (maximize, restore) по двойному щелчку в области обрабатываемых элементов управления.
Public Property AllowMove() As Boolean
Определяет, включена ли возможность перемещения окна при удерживании левой кнопки мыши в области обрабатываемых элементов управления.
Public Property AllowSystemMenu() As Boolean
Определяет, включена ли возможность вызывать стандартное меню окна щелчком правой кнопки мыши в области обрабатываемых элементов управления.
Public Sub Clear()
Удаляет все элементы управления из коллекции.
Public ReadOnly Property Controls() As System.Collections.ObjectModel.ReadOnlyCollection(Of System.Windows.Forms.Control)
Возвращает коллекцию обрабатываемых элементов управления.
Public Property Enabled() As Boolean
Определяет, включена ли обработка элементов управления, связанных с текущим экземпляром класса.
Public ReadOnly Property Form() As System.Windows.Forms.Form
Возвращает объект формы, с которой связан текущий экземпляр этого класса.
Public Sub New(ByVal form As System.Windows.Forms.Form, ByVal ParamArray nonWorkingAreaControls() As System.Windows.Forms.Control)
Конструктор класса. Требуется указание формы form, с которой будут связаны элементы управления. nonWorkingAreaControls() дополнительно позволяет перечислить элементы управления, которые нужно связать с новым экземпляром класса.
Public Sub Remove(ByVal control As System.Windows.Forms.Control)
Удаляет указанный элемент управления из коллекции.
Public Function ShowSystemMenu() As Boolean
Отображает системное меню окна в текущей позиции указателя мыши. Возвращает True, если меню удалось отобразить, в противном случае возвращает False.
Public Function ShowSystemMenu(ByVal screenX As Integer, ByVal screenY As Integer) As Boolean
Отображает системное меню окна в указанных координатах screenX и screenY. Возвращает True, если меню удалось отобразить, в противном случае возвращает False.
Public Shared Function ShowSystemMenu(ByVal window As System.Windows.Forms.IWin32Window, ByVal screenX As Integer, ByVal screenY As Integer) As Boolean
Отображает системное меню окна window в указанных координатах screenX и screenY. Возвращает True, если меню удалось отобразить, в противном случае возвращает False.
ProgressBarStateConstants
Константы состояний (свойство State) для HProgressBar и VProgressBar.
Public Const Normal As BinaryWind.Forms.ProgressBarStateConstants= 1
Public Const Error As BinaryWind.Forms.ProgressBarStateConstants= 2
Public Const Paused As BinaryWind.Forms.ProgressBarStateConstants= 3
VProgressBar
Класс, наследующий системный System.Windows.Forms.ProgressBar, полностью совместимый с ним и расширяющий его функциональность.
Как и HProgressBar, поддерживает состояния, а так же, в отличие от ProgressBar, не поддерживающего данный режим, отображает полосу прогресса вертикально.
Graphics
HsbColor
Структура, хранящая данные о цвете в формате HSB (hue, saturation, brightness), в отличие от системной структуры Color, использующей для этих целей RGB.
Public Property Alpha() As Integer
Возвращает или устанавливает уровень прозрачности цвета (альфа-канал).
Public Property Brightness() As Integer
Возвращает или устанавливает уровень яркости цвета (brightness).
Public Overrides Function Equals(ByVal obj As Object) As Boolean
Выполняет сравнение значений цвета двух экземпляров структуры HsbColor.
Public Overrides Function GetHashCode() As Integer
Возвращает хэш текущего экземпляра структуры.
Public Property Hue() As Integer
Возвращает или устанавливает тон цвета (hue).
Public Const MaxAlpha As Integer= 255
Public Const MaxBrightness As Integer= 100
Public Const MaxHue As Integer= 360
Public Const MaxSaturation As Integer= 100
Public Const MinAlpha As Integer= 0
Public Const MinBrightness As Integer= 0
Public Const MinHue As Integer= 0
Public Const MinSaturation As Integer= 0
Public Sub New(ByVal hue As Integer, ByVal saturation As Integer, ByVal brightness As Integer, ByVal alpha As Integer)
Создаёт новый экземпляр структуры HsbColor. Необходимо указать тон, насыщенность и яркость (hue, saturation, brightness). Возможно задание альфа-канала (прозрачность; alpha).
Public Sub New(ByVal color As System.Drawing.Color)
Создаёт новый экземпляр структуры HsbColor, основываясь на цвете color в формате RGB.
Public Shared Operator <>(ByVal hsb1 As BinaryWind.Graphics.HsbColor, ByVal hsb2 As BinaryWind.Graphics.HsbColor) As Boolean
Сравнивает два экземпляра структуры HsbColor и возвращает True, если их значения разные. В противном случае возвращает False.
Public Shared Operator =(ByVal hsb1 As BinaryWind.Graphics.HsbColor, ByVal hsb2 As BinaryWind.Graphics.HsbColor) As Boolean
Сравнивает два экземпляра структуры HsbColor и возвращает True, если их значения одинаковы. В противном случае возвращает False.
Public Shared Narrowing Operator CType(ByVal hsbColor As BinaryWind.Graphics.HsbColor) As System.Drawing.Color
Конвертирует экземпляр структуры HsbColor (HSB) в системный тип Color (RGB).
Public Property Saturation() As Integer
Возвращает или устанавливает насыщенность цвета (saturation).
Public Function ToColor() As System.Drawing.Color
Конвертирует экземпляр структуры HsbColor (HSB) в системный тип Color (RGB).
Public Function ToString() As String
Конвертирует значение этого экземпляра структуры в соответствующее строковое представление.
Information
ApplicationArchitecture
Набор инструментов для получения информации об особенностях архитектурной организации приложений и динамических библиотек.
Public Shared Function GetLinkerTimestamp(ByVal filePath As String) As Date
Возвращает временную отметку, оставленную компоновщиком в файле filePath формата Portable Executable (PE; exe, dll и другие). Обычно оно совпадает с датой компиляции приложения или динамической библиотеки.
Public Shared ReadOnly Property WordLength() As Integer
Возвращает длину машинного слова процессора, для которого предназначен текущий экземпляр приложения, из которого вызывана данная библиотечная функция. То есть, для x86 будет возвращено 32 (бита), а для x64 - 64 (бита).
Примечание. Для x86-приложения, запущенного в среде x64 будет возвращено 32, а не, как возможно ожидалось, 64. Эта функция определяет не разрядность процессора или операционной системы, а целевую архитектуру процессора, для которой собрано вызывающее её приложение.
IO
QuickSettings
Обеспечивает работу с одноуровневым набором параметров и их значений (ключ-значение).
Public Sub AddProperties(ByVal ParamArray keyValue() As String)
Добавляет в коллекцию одно или несколько параметров и их значений. keyValue() должен быть в формате "имя", "значение", "имя", "значение" и так далее. Число параметров должно быть чётным.
Public Sub AddProperty(ByVal name As String, ByVal value As String)
Добавляет в коллекцию новый параметр name со значением value.
Public ReadOnly Property Count() As Integer
Возвращает общее количество параметров в коллекции.
Public Function GetProperty(ByVal name As String, ByVal defaultValue As String) As String
Возвращает значение параметра name, если он существует в коллекции. Иначе возвращает defaultValue.
Public ReadOnly Property Key(ByVal index As Integer) As String
Возвращает имя параметра по его индексу index в коллекции.
Public Function PropertyExist(ByVal name As String) As Boolean
Возвращает True, если параметр с именем name существует в коллекции. В противном случае возвращает False.
Public Sub Read(ByVal fileName As String)
Читает и заменяет текущий набор параметров и их значений из файла fileName.
Public Sub Read(ByVal stream As System.IO.TextReader)
Читает и заменяет текущий набор параметров и их значений из TextReader-потока stream.
Public Function RemoveProperty(ByVal name As String) As Boolean
Удаляет параметр с именем name из коллекции. Возвращает True, если параметр был найден и успешно удалён. В противном случае, возвращает False.
Public Sub Save(ByVal fileName As String)
Записывает текущий набор параметров и их значений в файл fileName. Если файл уже существует, он будет заменён.
Public Sub Save(ByVal stream As System.IO.TextWriter)
Сохраняет текущий набор параметров и их значений в TextReader-поток stream.
Public Function SetProperty(ByVal name As String, ByVal value As String) As Boolean
Устанавливает значение параметра name равным value. Если параметр name не существует, то он будет создан. Возвращает True, если параметр с указанным значением уже существовал. Возвращает False, если параметр с указанным значением был создан.
Public Property Text() As String
Возвращает или устанавливает текст, определяющий набор параметров и их значений.
Public Shared Function ToDictionary(ByVal text As String) As System.Collections.Generic.Dictionary(Of String, String)
Преобразует текст в набор параметров и их значений. Возвращает Dictionary(Of String, String) в формате ключ-значение.
Public Shared Function ToString(ByVal properties As System.Collections.Generic.Dictionary(Of String, String)) As String
Преобразует набор параметров в текстовое представление.
Public Property Value(ByVal index As Integer) As Integer
Возвращает значение параметра по его индексу index в коллекции.
Scripting
Предоставляет базовые инструменты для обработки сценариев.
Public Shared Function FormatCommandLine(ByVal ParamArray command() As String) As String
Создаёт и возвращает команду для командной строки из её частей.
Public Shared Function ParseCommandLine(ByVal commandLine As String, ByVal singleArgument As Boolean) As String()
Разбивает командную строку commandLine на составные части и возвращает их в массиве строк. Если в тексте команды или параметра требуется использовать символ двойной кавычки, его необходимо экранировать символом ^. Следующая за ним кавычка воспринимается буквально и не считается началом или завершением значения в кавычках.
Также, передача singleArgument = True позволяет разделить commandLine на "команду и всё, что после неё", вместо стандартного поведения ("команда и параметры"). Для некоторых команд такое разделение целоесообразно, более удобно и позволяет сохранить единственный параметр без изменений (не заключая его в кавычки и никак не обрабатывая его значение. При этом экранирование символом ^ также не работает). Например, команда say, использующаяся во некоторых играх и отправляющая сообщение в общий чат:
say Всем привет! Кто-нибудь может объяснить, что такое "ParseCommandLine"?
При singleArgument = True say будет распознан как команда, а всё после него - как её единственный параметр. При этом наличие кавычек в этой строке никак не повлияет на её итоговый формат.
Win32
Содержит функциональность, специфичную для операционных систем семейства Windows.
Platform
Предоставляет информацию о конфигурации текущей платформы.
Public Shared ReadOnly Property OSVersion() As System.Version
Возвращает версию текущей операционной системы.
Примечание. Полезно при необходимости определить версию Windows, если она выше, чем 6.2. Например, Windows 10 подменяет реальную версию операционной системы на 6.2 для приложений, скомпилированных для предыдущих версий Windows.
TaskBar
Предоставляет информацию о Панели задач Windows.
Public Shared ReadOnly Property AlwaysOnTop() As Boolean
Возвращает True, если Панель задач настроена на отображение поверх всех окон.
Примечание. Начиная с Windows 7 Панель задач всегда находится в этом режиме, поэтому данное свойство всегда возвращает True и помечено атрибутом Obsolete() (устаревшее). На более ранних версиях Windows предоставляется актуальная информация.
Public Shared ReadOnly Property Attachment() As BinaryWind.Win32.TaskBarScreenEdge
Возвращает значение границы экрана, к которой в текущий момент привязана Панель задач.
Public Shared ReadOnly Property AutoHide() As Boolean
Возвращает True, если для Панели задач включен режим "автоматически скрывать с экрана".
Public Shared ReadOnly Property Rectangle() As System.Drawing.Rectangle
Возвращает прямоугольник, определяющий положение Панели задач на экране.
TaskBarScreenEdge As Integer
Перечисление, связанное со свойством BinaryWind.Win32.TaskBar.Attachment. Представляет границу экрана, к которой прикреплена Панель задач.
Public Const Left= 0
Public Const Top= 1
Public Const Right= 2
Public Const Bottom= 3
Категория: BinaryWind (.Net DLL) | Добавил: BinaryWind (12 Мая 2019)
Просмотров: 10 | Теги: Windows, dll, Library, binarywind, .Net | Рейтинг: 0.0/0
Всего комментариев: 0
Имя *:
Email *:
Все смайлы
Код *: