Função GetDialogSize

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A função GetDialogSize recupera o tamanho de uma caixa de diálogo de recurso.

Sintaxe

BOOL WINAPI GetDialogSize(
   int     iResourceID,
   DLGPROC pDlgProc,
   LPARAM  lParam,
   SIZE    *pResult
);

Parâmetros

iResourceID

Identificador de recurso da caixa de diálogo.

pDlgProc

Ponteiro para o procedimento da caixa de diálogo.

lParam

Valor passado na mensagem WM_INITDIALOG enviada para a caixa de diálogo temporária logo após sua criação.

pResult

Ponteiro para uma estrutura SIZE que recebe as dimensões da caixa de diálogo, em pixels de tela.

Retornar valor

Retornará TRUE se o recurso da caixa de diálogo tiver sido encontrado ou FALSE caso contrário.

Comentários

As páginas de propriedades podem usar essa função para retornar o tamanho real de exibição necessário. A maioria das páginas de propriedades são caixas de diálogo e, como tal, têm modelos de caixa de diálogo armazenados em arquivos de recurso. Os modelos usam unidades de caixa de diálogo que não são mapeadas diretamente para pixels de tela. No entanto, a função GetPageInfo de uma página de propriedades deve retornar o tamanho real de exibição em pixels. A página de propriedades pode chamar GetDialogSize para calcular o tamanho da exibição.

Essa função cria uma instância temporária da caixa de diálogo. Para evitar que a caixa de diálogo apareça na tela, o modelo da caixa de diálogo no arquivo de recurso não deve ter uma propriedade WS_VISIBLE.

Requisitos

Requisito Valor
parâmetro
Wxutil.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Funções auxiliares da página de propriedades