Compartilhar via


Propriedade FileDialog.ButtonName (Office)

Define ou obtém uma String que representa o texto que é exibido no botão de ação de uma caixa de diálogo de arquivo. Leitura/gravação.

Sintaxe

expressão. ButtonName

expression Uma variável que representa um objeto FileDialog.

Comentários

Por padrão, essa propriedade é definida como o texto padrão para o tipo de caixa de diálogo de arquivo. Por exemplo, no caso da caixa de diálogo Abrir , a propriedade é definida como "Abrir" por padrão. Essa cadeia de caracteres é limitada a 51 caracteres.

Exemplo

O exemplo a seguir exibe uma caixa de diálogo Selecionador de Arquivos usando o objeto FileDialog, e exibe cada arquivo selecionado em uma caixa de mensagem.

Sub Main() 
 
 'Declare a variable as a FileDialog object. 
 Dim fd As FileDialog 
 
 'Create a FileDialog object as a File Picker dialog box. 
 Set fd = Application.FileDialog(msoFileDialogFilePicker) 
 
 'Declare a variable to contain the path 
 'of each selected item. Even though the path is aString, 
 'the variable must be a Variant because For Each...Next 
 'routines only work with Variants and Objects. 
 Dim vrtSelectedItem As Variant 
 
 'Use a With...End With block to reference the FileDialog object. 
 With fd 
 
 'Change the text on the button. 
 .ButtonName = "Archive" 
 
 'Use the Show method to display the File Picker dialog box and return the user's action. 
 'If the user presses the button... 
 If .Show = -1 Then 
 
 'Step through eachString in the FileDialogSelectedItems collection. 
 For Each vrtSelectedItem In .SelectedItems 
 
 'vrtSelectedItem is aString that contains the path of each selected item. 
 'Use any file I/O functions that you want to work with this path. 
 'This example displays the path in a message box. 
 MsgBox "Selected item's path: " & vrtSelectedItem 
 
 Next vrtSelectedItem 
 'If the user presses Cancel... 
 Else 
 End If 
 End With 
 
 'Set the object variable to Nothing. 
 Set fd = Nothing 
 
End Sub

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.