Conteúdo
Índice 🔎︎

# Instrução Declare

Declara e define uma sub-rotina numa DLL que pretenda executar a partir do LibreOffice Basic.

Consulte também: FreeLibrary

## Sintaxe:

    Declare {Sub | Function} Nome Lib "Libname" [Alias "Nome alternativo"] [Parameter] [As Tipo]

## Parâmetros:

Nome: um nome diferente do definido na DLL, para invocar a sub-rotina do LibreOffice Basic.

Nome alternativo: nome da sub-rotina conforme definido na DLL.

NomeBib: Nome do ficheiro ou sistema da DLL. Esta biblioteca é automaticamente carregada na primeira vez que a função é utilizada.

Lista de argumentos: a lista dos parâmetros que representam os valores transferidos para o procedimento quando este é invocado. O tipo e o número dos parâmetros dependem do procedimento executado.

Tipo: define o tipo de dados do valor devolvido por uma função. Pode excluir este parâmetro introduzindo um carácter de declaração de tipo após o nome.

Para transferir um parâmetro para uma sub-rotina como um valor em vez de uma referência, o parâmetro terá de ser indicado pela palavra-chave ByVal.

## Exemplo:

    Declare Sub MyMessageBeep Lib "user32.dll" Alias "MessageBeep" ( Long )
    Sub ExampleDeclare
    Dim lValue As Long
        lValue = 5000
        MyMessageBeep( lValue )
        FreeLibrary("user32.dll" )
    End Sub