Tengo el siguiente código...

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

... la idea es que puedo tener texto de varias líneas para el botón, pero el texto siempre está oscurecido por la imagen de fondo del botón UIB. Una llamada de registro para mostrar las subvistas del botón muestra que se ha agregado el UILabel, pero el texto en sí no se puede ver. ¿Es esto un error en UIButton o estoy haciendo algo mal?

Para iOS 6 y superior, use lo siguiente para permitir varias líneas:

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 y versiones inferiores, use lo siguiente para permitir varias líneas:

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

2017, para iOS9 en adelante ,

en general, solo haz estas dos cosas:

1. elija "Texto atribuido"
2. en la ventana emergente "Salto de línea", seleccione "Ajuste de línea"

La respuesta seleccionada es correcta, pero si prefiere hacer este tipo de cosas en Interface Builder, puede hacerlo:

Si desea agregar un botón con el título centrado con varias líneas, establezca la configuración de Interface Builder para el botón:

[ ]

Para iOS 6:

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

Como

UILineBreakModeWordWrap and UITextAlignmentCenter

están en desuso en iOS 6 en adelante.

Para repetir la sugerencia de Roger Nolan, pero con código explícito, esta es la solución general:

button.titleLabel?.numberOfLines = 0

SWIFT 3

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

En Xcode 9.3 puedes hacerlo usando el guión gráfico como se muestra a continuación,

Debe configurar el texto del título del botón Alineación al centro

button.titleLabel?.textAlignment = .center

No es necesario establecer el texto del título con una nueva línea (\ n) como a continuación,

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

Simplemente establezca el título,

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

Aquí está el resultado,

Hay una manera mucho más fácil:

someButton.lineBreakMode = UILineBreakModeWordWrap;

(Editar para iOS 3 y posterior :)

someButton.titleLabel.lineBreakMode = UILineBreakModeWordWrap;

Alinear a la izquierda en iOS7 con autolayout:

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

Tuve un problema con el diseño automático, después de habilitar varias líneas, el resultado fue el siguiente: por lo que el tamaño no afecta el tamaño del botón que he agregado en función de (en este caso, contentEdgeInsets fue (10, 10, 10, 10 ) después de llamar : espero que te ayude (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)
            ])
    }

}

En primer lugar, debe tener en cuenta que UIButton ya tiene un UILabel dentro. Puedes configurarlo usando –setTitle:forState:.

El problema con su ejemplo es que necesita establecer la numberOfLinespropiedad de UILabel en algo diferente a su valor predeterminado de 1. También debe revisar la lineBreakModepropiedad.

Para aquellos que usan el guión gráfico de Xcode 4, puede hacer clic en el botón, y en el panel derecho de Utilidades, debajo del Inspector de atributos, verá una opción para Salto de línea. Elija Word Wrap, y debería estar listo para comenzar.

Las respuestas aquí le dicen cómo lograr el título del botón multilínea mediante programación.

Solo quería agregar que si está usando guiones gráficos, puede escribir [Ctrl + Enter] para forzar una nueva línea en el campo de título de un botón.

HTH

Tienes que agregar este código:

buttonLabel.titleLabel.numberOfLines = 0;

En cuanto a la idea de Brent de poner el título UILabel como vista de hermano, no me parece una muy buena idea. Sigo pensando en problemas de interacción con el UILabel debido a que sus eventos táctiles no llegan a la vista del UIButton.

Por otro lado, con un UILabel como subvista del UIButton, me siento bastante cómodo sabiendo que los eventos táctiles siempre se propagarán a la supervista del UILabel.

Tomé este enfoque y no noté ninguno de los problemas reportados con backgroundImage. Agregué este código en -titleRectForContentRect: de una subclase UIButton, pero el código también se puede colocar en la rutina de dibujo de la supervista UIButton, que en ese caso reemplazará todas las referencias a sí mismo con la variable 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;
}

Me tomé el tiempo y escribí un poco más sobre esto aquí . Allí, también apunto una solución más corta, aunque no se ajusta a todos los escenarios e involucra el pirateo de algunas vistas privadas. También allí, puede descargar una subclase de UIButton lista para ser utilizada.

Si usa el diseño automático en iOS 6, es posible que también deba configurar la preferredMaxLayoutWidthpropiedad:

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

Establecer lineBreakMode en NSLineBreakByWordWrapping (ya sea en IB o código) hace que la etiqueta del botón sea multilínea, pero no afecta el marco del botón.

Si el botón tiene un título dinámico, hay un truco: coloque UILabel oculto con la misma fuente y ate su altura a la altura del botón con diseño; cuando establece el texto en el botón y la etiqueta y la distribución automática hará todo el trabajo.

Nota

La altura del tamaño intrínseco del botón de una línea es más grande que la de la etiqueta, por lo que para evitar que la altura de la etiqueta se reduzca, la prioridad de contenido vertical debe ser mayor que la resistencia de compresión de contenido vertical del botón.

En Swift 5.0 y Xcode 10.2

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

En su llamada de ViewController así

button.btnMultipleLines()//This is your button

Swift 5, para texto de varias líneas en UIButton

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

Funciona perfectamente

Agregue para usar esto con un archivo de configuración como Plist, debe usar CDATA para escribir el título multilínea, así:

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

Si usa el diseño 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)

En estos días, si realmente necesita que este tipo de cosas sean accesibles en el generador de interfaces caso por caso, puede hacerlo con una extensión simple como esta:

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

Luego, simplemente puede establecer numberOfLines como un atributo en cualquier subclase UIButton o UIButton como si fuera una etiqueta. Lo mismo ocurre con una gran cantidad de otros valores generalmente inaccesibles, como el radio de la esquina de la capa de una vista o los atributos de la sombra que proyecta.

Tira tu propio botón de clase. Es, con mucho, la mejor solución a largo plazo. UIButton y otras clases de UIKit son muy restrictivas en cómo puede personalizarlas.

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

self.btnError.titleLabel?.textAlignment = .center

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

Incorporé la respuesta de jessecurry en STAButton, que es parte de mi biblioteca de código abierto STAControls . Actualmente lo uso dentro de una de las aplicaciones que estoy desarrollando y funciona para mis necesidades. Siéntase libre de abrir problemas sobre cómo mejorarlo o enviarme solicitudes de extracción.

Para corregir el espacio de la etiqueta del título en el botón, establezca titleEdgeInsets y otras propiedades 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)

PD: probé establecer titleLabel? .TextAlignment no es necesario y el título se alinea .natural.

Aunque está bien agregar una subvista a un control, no hay garantía de que realmente funcione, porque el control podría no esperar que esté allí y, por lo tanto, podría comportarse mal. Si puede salirse con la suya, simplemente agregue la etiqueta como una vista similar del botón y configure su marco para que se superponga al botón; siempre que esté configurado para aparecer en la parte superior del botón, nada de lo que pueda hacer el botón lo ocultará.

En otras palabras:

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