VintaSoft Twain .NET SDK 14.1: Руководство для .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
    )
    public: void Add(
    ushort id
    )
    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 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

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