BCM_GETIDEALSIZE mensagem

Obtém o tamanho do botão que melhor se ajusta ao texto e à imagem, se uma lista de imagens estiver presente. Você pode enviar essa mensagem explicitamente ou usar a macro Button_GetIdealSize .

Parâmetros

wParam

Não usado; deve ser zero.

lParam

Um ponteiro para uma estrutura SIZE que recebe o tamanho desejado do botão, incluindo texto e lista de imagens, se presente. O aplicativo de chamada é responsável por alocar essa estrutura. Defina os membros cx e cy como zero para ter a altura e a largura ideais retornadas na estrutura SIZE . Para especificar uma largura de botão, defina o membro cx para a largura do botão desejada. O sistema calculará a altura ideal para essa largura e a retornará no membro cy .

Valor retornado

Se a mensagem for bem-sucedida, ela retornará TRUE. Caso contrário, retornará FALSE.

Comentários

Observação

Se nenhuma largura de botão especial for desejada, você deverá definir ambos os membros de SIZE como zero para calcular e retornar a altura e a largura ideais. Se o valor do membro cx for maior que zero, esse valor será considerado a largura do botão desejada e a altura ideal para essa largura será calculada e retornada no membro cy .

Essa mensagem é mais aplicável a PushButtons. Quando enviada para um PushButton, a mensagem recupera o retângulo delimitador necessário para exibir o texto do botão. Além disso, se o PushButton tiver uma lista de imagens, o retângulo delimitador também será dimensionado para incluir a imagem do botão.

Quando enviado para um botão de qualquer outro tipo, o tamanho do retângulo da janela do controle é recuperado.

Observação

Para usar essa mensagem, você deve fornecer um manifesto especificando Comclt32.dll versão 6.0. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Commctrl.h