Função CxEntrada

Nota: Queremos fornecer-lhe os conteúdos de ajuda mais recentes o mais rapidamente possível e no seu idioma. Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode informar-nos se as informações foram úteis no final desta página? Eis o artigo em inglês para referência.

Apresenta um aviso numa caixa de diálogo, espera para o utilizador a entrada de texto ou clique num botão e devolve uma cadeia que contém os conteúdos da caixa de texto.

Sintaxe

CxEntrada linha de comandos do ([título ] [predefinição ] [, posx ] [, posy ] [, ficheiro de ajuda ] [contexto ] )

A sintaxe da função CxEntrada tem os seguintes argumentos:

Argumento

Descrição

linha de comandos

Obrigatório. Expressão de cadeia apresentada como a mensagem na caixa de diálogo. O comprimento máximo de linha de comandos é aproximadamente 1024 caracteres, consoante a largura de carateres utilizados. Se pedido é constituída por mais do que uma linha, pode separar as linhas, utilizando um carácter de retorno (Chr(13)), um caráter de avanço de linha (Chr(10)) ou o caráter de retorno – avanço de linha de transporte combinação (Chr(13) & Chr(10)) entre cada linha.

título

Opcional. Expressão de cadeia apresentada na barra de título da caixa de diálogo. Se omitir título, o nome da aplicação é colocado na barra de título.

predefinição

Opcional. Expressão de cadeia apresentada na caixa de texto como a resposta predefinida se não for fornecida não outra entrada. Se omitir predefinida, na caixa de texto é apresentada vazia.

posx

Opcional. Expressão numérica que especifica, em twips, a distância horizontal do limite esquerdo da caixa de diálogo a partir do limite esquerdo do ecrã. Se posx for omitido, a caixa de diálogo é centrada horizontalmente.

posy

Opcional. Expressão numérica que especifica, em twips, a distância vertical entre o limite superior da caixa de diálogo situado na parte superior do ecrã. Se posy for omitido, a caixa de diálogo verticalmente é posicionada aproximadamente um terceiro à forma como o ecrã para baixo.

ficheiro de ajuda

Opcional. Expressão de cadeia que identifica o ficheiro de ajuda para utilizar para fornecer ajuda sensível ao contexto para a caixa de diálogo. Se o ficheiro de ajuda é fornecido, contexto também tem de ser fornecido.

contexto

Opcional. Expressão numérica que é o número de contexto de ajuda atribuído para o tópico de ajuda adequado pelo autor da ajuda. Se o contexto for fornecido, ficheiro de ajuda também tem de ser fornecido.


Observações

Quando são fornecidos o ficheiro de ajuda e o contexto , o utilizador pode premir F1 (Windows) ou da ajuda (Macintosh) para ver o tópico de ajuda correspondente ao contexto. Algumas aplicação anfitriã, por exemplo, Microsoft Office Excel 2007, adicione também automaticamente um botão Ajuda para a caixa de diálogo. Se o utilizador clica em OK ou premir ENTER, a função CxEntrada devolve qualquer que seja na caixa de texto. Se o utilizador clica em Cancelar, a função devolverá uma cadeia de comprimento zero ("").

Nota: Para especificar mais do que o primeiro argumento com nome, tem de utilizar CxEntrada uma expressão. Para omitir alguns argumentos posicionais, tem de incluir o delimitador vírgula correspondente.

Exemplo

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo mostra várias formas de utilizar a função CxEntrada para pedir ao utilizador que introduza um valor. Se x e y são omitidas posições, a caixa de diálogo automaticamente está centrada para os respetivos eixos. A variável MyValue contém o valor introduzido pelo utilizador se o utilizador clica em OK ou quando prime a tecla ENTER. Se o utilizador clica em Cancelar, é devolvida uma cadeia de comprimento zero.

Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3" ' Set prompt.
Title = "InputBox Demo" ' Set title.
Default = "1" ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)
' Use Helpfile and context.
' The Help button is added automatically.
MyValue = InputBox(Message, Title,,,,"DEMO.HLP", 10)
' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)
Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×