VintaSoft Twain .NET SDK 15.4: Руководство для .NET разработчика
Vintasoft.WinTwain Namespace / DeviceCapabilityCollection Class / Add(UInt16) Method
Синтаксис Exceptions Ремарки Example Требования Смотрите также
В этом разделе
Add(UInt16) Метод (DeviceCapabilityCollection)
В этом разделе
Добавляет "пользовательскую" возможность в список возможностей.
Синтаксис
'Declaration

Public Sub Add( _
ByVal id
Идентификатор возможности.
As UShort _
)
public void Add(
ushort id
)

Parameters

id
Идентификатор возможности.
Исключения
ИсключениеОписание
Выбрасывается, если возможность с указанным идентификатором уже существует.
Ремарки

По умолчанию устройство предоставляет идентификаторы поддерживаемых возможностей, а SDK автоматически добавляет все возможности, поддерживаемые устройством, в список возможностей.
Некоторые "плохие" устройства не предоставляют идентификаторы поддерживаемых возможности или предоставить неправильные идентификаторы поддерживаемых возможностей. Этот метод предназначен для решения этой проблемы. Используйте этот метод, только если вам действительно нужно добавить возможность в список возможностей.

Пример

Вот C#/VB.NET код, который демонстрирует, как добавить "пользовательскую" возможность в список возможностей.


''' <summary>
''' Adds the "custom" capability to the device capability collection.
''' </summary>
Public Shared Sub AddCustomDeviceCapability(device As Vintasoft.Twain.Device)
    ' open the device
    device.Open()

    Dim customCapId As System.UInt16 = 30000
    ' add the "custom" capability to the device capability collection
    device.Capabilities.Add(customCapId)

    ' get the "custom" capability
    Dim cap30000 As Vintasoft.Twain.DeviceCapability = device.Capabilities.Find(customCapId)
    Try
        ' set the current value of "custom" capability to True
        cap30000.SetValue(True)
    Catch ex As System.Exception
        System.Console.WriteLine(String.Format("Error: {0}", ex.Message))
    End Try
End Sub


/// <summary>
/// Adds the "custom" capability to the device capability collection.
/// </summary>
public static void AddCustomDeviceCapability(Vintasoft.Twain.Device device)
{
    // open the device
    device.Open();

    System.UInt16 customCapId = 30000;
    // add the "custom" capability to the device capability collection
    device.Capabilities.Add(customCapId);

    // get the "custom" capability
    Vintasoft.Twain.DeviceCapability cap30000 = device.Capabilities.Find(customCapId);
    try
    {
        // set the current value of "custom" capability to True
        cap30000.SetValue(true);
    }
    catch (System.Exception ex)
    {
        System.Console.WriteLine(string.Format("Error: {0}", ex.Message));
    }
}

Требования

Целевые платформы: .NET 10; .NET 9; .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

Смотрите также