Eu tenho o seguinte código...

UILabel *buttonLabel = [[UILabel alloc] initWithFrame:targetButton.bounds];
buttonLabel.text = @"Long text string";
[targetButton addSubview:buttonLabel];
[targetButton bringSubviewToFront:buttonLabel];

... a ideia é que eu posso ter texto com várias linhas para o botão, mas o texto é sempre obscurecido pela backgroundImage do UIButton. Uma chamada de log para mostrar as subvisões do botão mostra que o UILabel foi adicionado, mas o texto em si não pode ser visto. Isso é um bug no UIButton ou estou fazendo algo errado?

Para iOS 6 e superior, use o seguinte para permitir várias linhas:

button.titleLabel.lineBreakMode = NSLineBreakByWordWrapping;
// you probably want to center it
button.titleLabel.textAlignment = NSTextAlignmentCenter; // if you want to 
[button setTitle: @"Line1\nLine2" forState: UIControlStateNormal];

Para iOS 5 e abaixo, use o seguinte para permitir várias linhas:

button.titleLabel.lineBreakMode = UILineBreakModeWordWrap;
// you probably want to center it
button.titleLabel.textAlignment = UITextAlignmentCenter;
[button setTitle: @"Line1\nLine2" forState: UIControlStateNormal];

2017, para iOS9 em diante ,

Geralmente, basta fazer estas duas coisas:

1. escolha "Texto atribuído"
2. no pop-up "Quebra de linha", selecione " Quebra de linha "

A resposta selecionada está correta, mas se você preferir fazer isso no Interface Builder, pode fazer o seguinte:

Se você deseja adicionar um botão com o título centralizado em várias linhas, defina as configurações do Interface Builder para o botão:

[ ]

Para o IOS 6:

button.titleLabel.lineBreakMode = NSLineBreakByWordWrapping;
button.titleLabel.textAlignment = NSTextAlignmentCenter;

Como

UILineBreakModeWordWrap and UITextAlignmentCenter

são preteridos no IOS 6 em diante ..

Para reafirmar a sugestão de Roger Nolan, mas com código explícito, esta é a solução geral:

button.titleLabel?.numberOfLines = 0

SWIFT 3

button.titleLabel?.lineBreakMode = .byWordWrapping
button.titleLabel?.textAlignment = .center  
button.setTitle("Button\nTitle",for: .normal)

No Xcode 9.3, você pode fazer isso usando o storyboard como abaixo,

Você precisa definir o texto do título do botão

button.titleLabel?.textAlignment = .center

Você não precisa definir o texto do título com a nova linha (\ n), como abaixo,

button.setTitle("Good\nAnswer",for: .normal)

Basta definir o título,

button.setTitle("Good Answer",for: .normal)

Aqui está o resultado,

Existe uma maneira muito mais fácil:

someButton.lineBreakMode = UILineBreakModeWordWrap;

(Editar para iOS 3 e posterior :)

someButton.titleLabel.lineBreakMode = UILineBreakModeWordWrap;

Alinhar à esquerda no iOS7 com o layout automático:

button.titleLabel.lineBreakMode = NSLineBreakByWordWrapping;
button.titleLabel.textAlignment = NSTextAlignmentLeft;
button.contentHorizontalAlignment = UIControlContentHorizontalAlignmentLeft;

Eu tive um problema com o layout automático, depois de ativar várias linhas, o resultado foi o seguinte: portanto, o tamanho não afeta o tamanho do botão que eu adicionei com base (nesse caso, contentEdgeInsets era (10, 10, 10, 10 ) após ligar : espero que ajude você (swift 5.0):

titleLabel
ConstraintscontentEdgeInsets
makeMultiLineSupport()

extension UIButton {

    func makeMultiLineSupport() {
        guard let titleLabel = titleLabel else {
            return
        }
        titleLabel.numberOfLines = 0
        titleLabel.setContentHuggingPriority(.required, for: .vertical)
        titleLabel.setContentHuggingPriority(.required, for: .horizontal)
        addConstraints([
            .init(item: titleLabel,
                  attribute: .top,
                  relatedBy: .greaterThanOrEqual,
                  toItem: self,
                  attribute: .top,
                  multiplier: 1.0,
                  constant: contentEdgeInsets.top),
            .init(item: titleLabel,
                  attribute: .bottom,
                  relatedBy: .greaterThanOrEqual,
                  toItem: self,
                  attribute: .bottom,
                  multiplier: 1.0,
                  constant: contentEdgeInsets.bottom),
            .init(item: titleLabel,
                  attribute: .left,
                  relatedBy: .greaterThanOrEqual,
                  toItem: self,
                  attribute: .left,
                  multiplier: 1.0,
                  constant: contentEdgeInsets.left),
            .init(item: titleLabel,
                  attribute: .right,
                  relatedBy: .greaterThanOrEqual,
                  toItem: self,
                  attribute: .right,
                  multiplier: 1.0,
                  constant: contentEdgeInsets.right)
            ])
    }

}

Primeiro de tudo, você deve estar ciente de que o UIButton já possui um UILabel dentro dele. Você pode configurá-lo usando –setTitle:forState:.

O problema com o seu exemplo é que você precisa definir a numberOfLinespropriedade do UILabel para algo diferente do valor padrão de 1. Você também deve revisar a lineBreakModepropriedade.

Para aqueles que estão usando o storyboard do Xcode 4, clique no botão e, no painel Utilitários do lado direito, em Inspetor de Atributos, você verá uma opção para Quebra de Linha. Escolha Quebra de linha, e você deve estar pronto.

As respostas aqui mostram como obter o título do botão com várias linhas programaticamente.

Eu só queria acrescentar que, se você estiver usando storyboards, poderá digitar [Ctrl + Enter] para forçar uma nova linha no campo de título de um botão.

HTH

Você precisa adicionar este código:

buttonLabel.titleLabel.numberOfLines = 0;

Quanto à idéia de Brent de colocar o título UILabel como visão de irmão, não me parece uma idéia muito boa. Eu continuo pensando em problemas de interação com o UILabel devido a seus eventos de toque que não passam pela visão do UIButton.

Por outro lado, com um UILabel como sub-visualização do UIButton, estou bastante confortável sabendo que os eventos de toque sempre serão propagados para a super-visão do UILabel.

Eu segui essa abordagem e não percebi nenhum dos problemas relatados com backgroundImage. Eu adicionei esse código na -titleRectForContentRect: de uma subclasse UIButton, mas o código também pode ser colocado na rotina de desenho da superview UIButton, que nesse caso você deve substituir todas as referências a self pela variável UIButton.

#define TITLE_LABEL_TAG 1234

- (CGRect)titleRectForContentRect:(CGRect)rect
{   
    // define the desired title inset margins based on the whole rect and its padding
    UIEdgeInsets padding = [self titleEdgeInsets];
    CGRect titleRect = CGRectMake(rect.origin.x    + padding.left, 
                                  rect.origin.x    + padding.top, 
                                  rect.size.width  - (padding.right + padding.left), 
                                  rect.size.height - (padding.bottom + padding].top));

    // save the current title view appearance
    NSString *title = [self currentTitle];
    UIColor  *titleColor = [self currentTitleColor];
    UIColor  *titleShadowColor = [self currentTitleShadowColor];

    // we only want to add our custom label once; only 1st pass shall return nil
    UILabel  *titleLabel = (UILabel*)[self viewWithTag:TITLE_LABEL_TAG];


    if (!titleLabel) 
    {
        // no custom label found (1st pass), we will be creating & adding it as subview
        titleLabel = [[UILabel alloc] initWithFrame:titleRect];
        [titleLabel setTag:TITLE_LABEL_TAG];

        // make it multi-line
        [titleLabel setNumberOfLines:0];
        [titleLabel setLineBreakMode:UILineBreakModeWordWrap];

        // title appearance setup; be at will to modify
        [titleLabel setBackgroundColor:[UIColor clearColor]];
        [titleLabel setFont:[self font]];
        [titleLabel setShadowOffset:CGSizeMake(0, 1)];
        [titleLabel setTextAlignment:UITextAlignmentCenter];

        [self addSubview:titleLabel];
        [titleLabel release];
    }

    // finally, put our label in original title view's state
    [titleLabel setText:title];
    [titleLabel setTextColor:titleColor];
    [titleLabel setShadowColor:titleShadowColor];

    // and return empty rect so that the original title view is hidden
    return CGRectZero;
}

Demorei um pouco e escrevi um pouco mais sobre isso aqui . Lá, também aponto uma solução mais curta, embora ela não se encaixe perfeitamente em todos os cenários e envolva algumas visualizações privadas de hackers. Também é possível baixar uma subclasse UIButton pronta para ser usada.

Se você usa o layout automático no iOS 6, também pode ser necessário definir a preferredMaxLayoutWidthpropriedade:

button.titleLabel.lineBreakMode = NSLineBreakByWordWrapping;
button.titleLabel.textAlignment = NSTextAlignmentCenter;
button.titleLabel.preferredMaxLayoutWidth = button.frame.size.width;

Definir lineBreakMode como NSLineBreakByWordWrapping (no IB ou no código) torna o rótulo do botão multilinha, mas não afeta o quadro do botão.

Se o botão tiver título dinâmico, existe um truque: coloque o UILabel oculto com a mesma fonte e amarre sua altura à altura do botão com layout; quando definir o texto como botão e rotular e o layout automático fará todo o trabalho.

Nota

A altura do tamanho intrínseco do botão de uma linha é maior que a da etiqueta; portanto, para evitar que a altura da etiqueta diminua, é vertical A Prioridade de abraço de conteúdo deve ser maior que a resistência vertical à compressão de conteúdo do botão.

No Swift 5.0 e no Xcode 10.2

//UIButton extension
extension UIButton {
     //UIButton properties
     func btnMultipleLines() {
         titleLabel?.numberOfLines = 0
         titleLabel?.lineBreakMode = .byWordWrapping
         titleLabel?.textAlignment = .center        
     }
}

Na sua chamada ViewController como esta

button.btnMultipleLines()//This is your button

Swift 5, para texto de várias linhas no UIButton

  let button = UIButton()
  button.titleLabel?.lineBreakMode = .byWordWrapping
  button.titleLabel?.textAlignment = .center
  button.titleLabel?.numberOfLines = 0 // for Multi line text

Funciona perfeitamente.

Adicione para usar isso com o arquivo de configuração como o Plist, você precisa usar o CDATA para escrever o título com várias linhas, assim:

<string><![CDATA[Line1
Line2]]></string>

Se você usa o layout automático.

button.titleLabel?.adjustsFontSizeToFitWidth = true
button.titleLabel?.numberOfLines = 2

swift 4.0

btn.titleLabel?.lineBreakMode = .byWordWrapping
btn.titleLabel?.textAlignment = .center
btn.setTitle( "Line1\nLine2", for: .normal)

Hoje em dia, se você realmente precisa desse tipo de coisa para ser acessível no construtor de interface caso a caso, pode fazê-lo com uma extensão simples como esta:

extension UIButton {
    @IBInspectable var numberOfLines: Int {
        get { return titleLabel?.numberOfLines ?? 1 }
        set { titleLabel?.numberOfLines = newValue }
    }
}

Em seguida, você pode simplesmente definir numberOfLines como um atributo em qualquer subclasse UIButton ou UIButton como se fosse um rótulo. O mesmo vale para uma série de outros valores geralmente inacessíveis, como o raio do canto da camada de uma vista ou os atributos da sombra que ela lança.

Role sua própria classe de botão. É de longe a melhor solução a longo prazo. O UIButton e outras classes do UIKit são muito restritivas na maneira como você pode personalizá-las.

self.btnError.titleLabel?.lineBreakMode = NSLineBreakMode.byWordWrapping

self.btnError.titleLabel?.textAlignment = .center

self.btnError.setTitle("Title", for: .normal)

Incorporei a resposta de jessecurry no STAButton, que faz parte da minha biblioteca de código aberto STAControls . Atualmente, eu o uso em um dos aplicativos que estou desenvolvendo e funciona para minhas necessidades. Fique à vontade para abrir questões sobre como aprimorá-lo ou me enviar solicitações pull.

Para corrigir o espaçamento do rótulo do título no botão, defina titleEdgeInsets e outras propriedades antes de setTitle:

    let set = UIButton()
    sut.titleLabel?.lineBreakMode = .byWordWrapping
    sut.titleLabel?.numberOfLines = 0
    sut.titleEdgeInsets = UIEdgeInsets(top: 10, left: 10, bottom: 20, right: 20)
    sut.setTitle("Dummy button with long long long long long long long long title", for: .normal)

PS Eu testei a configuração titleLabel? .TextAlignment não é necessário e o título se alinha .natural.

Embora seja bom adicionar uma subvisão a um controle, não há garantia de que realmente funcione, porque o controle pode não esperar que esteja lá e, portanto, se comportar mal. Se você conseguir se safar, basta adicionar o rótulo como uma visão irmão do botão e definir seu quadro para que ele se sobreponha ao botão; desde que esteja definido para aparecer na parte superior do botão, nada que ele possa fazer o ocultará.

Em outras palavras:

[button.superview addSubview:myLabel];
myLabel.center = button.center;