如何為 QR 碼添加邊距

This article was translated from English: Does it need improvement?
Translated
View the article in English

在品牌廣告中,正確調整 QR 碼的尺寸是平衡視覺衝擊與技術可讀性的關鍵步驟。 為此,使用邊距(通常稱為"靜區")可提升 QR 碼的可讀性,並確保掃描裝置能在各種獨特的版面配置中正確識別該碼。 對寬度、高度及整體比例的具體調整,將直接影響最終的輸出比例與視覺呈現效果。

本指南將示範如何利用邊距功能,透過 IronQR 有效調整 QR 碼大小並進行邊框設定,確保其能完美融入任何專業版面配置。

為 QR 碼添加邊距

透過在 QrStyleOptions 類別中設定 Margins 屬性,即可建立適當的靜音區。 此屬性接受一個整數參數,用以定義 QR 碼四邊周圍的統一空白邊框。

在此範例中,我們定義一個邊距為 40 像素的樣式設定,於渲染過程中將這些設定套用至 QR 碼,並將生成的圖像儲存為 PNG 檔案。

:path=/static-assets/qr/content-code-examples/how-to/add-margins-qr-code.cs
using IronQr;
using IronSoftware.Drawing;

QrStyleOptions styleOptions = new QrStyleOptions
{
    // Set all margins to 40px
    Margins = 40,

};

string url = "https://ironsoftware.com/csharp/qr/";

// Create QR code
QrCode qr = QrWriter.Write(url);

// Save QR code as a bitmap using the style options
AnyBitmap qrImage = qr.Save(styleOptions);

// Save QR code bitmap as file
qrImage.SaveAs("qr-uniform-margins.png");
Imports IronQr
Imports IronSoftware.Drawing

Dim styleOptions As New QrStyleOptions With {
    .Margins = 40
}

Dim url As String = "https://ironsoftware.com/csharp/qr/"

' Create QR code
Dim qr As QrCode = QrWriter.Write(url)

' Save QR code as a bitmap using the style options
Dim qrImage As AnyBitmap = qr.Save(styleOptions)

' Save QR code bitmap as file
qrImage.SaveAs("qr-uniform-margins.png")
$vbLabelText   $csharpLabel

輸出

靜音區 QR 碼

為特定邊緣添加邊距

針對非對稱版面配置,請在 QrStyleOptions 內使用 MarginLeftMarginRight 屬性。 這能讓您獨立精確地控制靜音區的每一側。

在此範例中,針對每個邊距定義了自訂值,並搭配特定尺寸與背景顏色。

:path=/static-assets/qr/content-code-examples/how-to/add-specific-margins-qr-code.cs
using IronQr;
using IronSoftware.Drawing;

// Configure QR code styling with individual margins and background color
QrStyleOptions combinedOptions = new QrStyleOptions
{
    Dimensions = 400,
    MarginTop = 50,
    MarginBottom = 50,
    MarginLeft = 20,
    MarginRight = 20,
    BackgroundColor = IronSoftware.Drawing.Color.LightYellow,
};

string url = "https://ironsoftware.com/";

// Generate QR code from URL
QrCode qrCombined = QrWriter.Write(url);

// Apply styling options and export as bitmap
AnyBitmap qrCombinedImage = qrCombined.Save(combinedOptions);

// Save QR code to file
qrCombinedImage.SaveAs("qr-custom-margins.png");
Imports IronQr
Imports IronSoftware.Drawing

' Configure QR code styling with individual margins and background color
Dim combinedOptions As New QrStyleOptions With {
    .Dimensions = 400,
    .MarginTop = 50,
    .MarginBottom = 50,
    .MarginLeft = 20,
    .MarginRight = 20,
    .BackgroundColor = IronSoftware.Drawing.Color.LightYellow
}

Dim url As String = "https://ironsoftware.com/"

' Generate QR code from URL
Dim qrCombined As QrCode = QrWriter.Write(url)

' Apply styling options and export as bitmap
Dim qrCombinedImage As AnyBitmap = qrCombined.Save(combinedOptions)

' Save QR code to file
qrCombinedImage.SaveAs("qr-custom-margins.png")
$vbLabelText   $csharpLabel

輸出

如您所見,垂直邊距明顯比水平邊距更寬。

選擇性邊距間距

已添加邊距的生成 QR 碼

靜音區 QR 碼
選擇性邊距間距

常見問題

QR 碼中的邊距是什麼?

邊距(亦稱靜區)是指 QR 碼周圍的空白區域。它們有助於提高可讀性,並確保掃描裝置能輕鬆識別該碼。

邊距如何影響 QR 碼的掃描效果?

邊距透過提供緩衝區,防止鄰近的視覺元素干擾 QR 碼的可讀性,從而確保掃描裝置能正確讀取 QR 碼。

如何在 C# 中為 QR 碼添加邊距?

您可透過 IronQR程式庫,在 C# 中為 QR 碼新增邊距。透過設定 `QrStyleOptions` 類別中的 `Margins` 屬性,即可在 QR 碼周圍定義均勻的空白邊框。

我可以為 QR 碼的每一邊設定不同的邊距嗎?

是的,透過 IronQR,您可以使用 `MarginTop`、`MarginBottom`、`MarginLeft` 和 `MarginRight` 等屬性,為 QR 碼的每一邊設定不同的邊距,以實現非對稱佈局。

IronQR 中的 `QrStyleOptions` 類別有何用途?

IronQR 中的 `QrStyleOptions` 類別可讓您自訂 QR 碼的外觀,包括設定邊距、尺寸及其他樣式選項,以呈現 Professional 版面配置。

如何將添加了邊距的 QR 碼儲存為圖片?

使用 IronQR 設定 QR 碼的邊距後,即可渲染並將其儲存為 PNG 等圖像檔案,供外部使用。

為何應使用 IronQR 來添加 QR 碼邊距?

IronQR 提供了一種簡單且高效的方式,可在 C# 中自訂 QR 碼邊距及其他樣式選項,確保完美契合任何 Professional 或品牌化的版面配置。

在 IronQR 中是否可以為 QR 碼設定背景顏色?

是的,IronQR 允許您為 QR 碼設定背景顏色,在維持可讀性的同時提升視覺吸引力。

使用 IronQR 時,QR 碼可以儲存為哪些檔案類型?

透過 IronQR,您可以將 QR 碼儲存為各種圖像檔案格式(例如 PNG),以便在不同的應用程式和平台上靈活運用。

Ahmad Sohail
全端開發者

Ahmad 是一位全端開發者,具備扎實的 C#、Python 及網頁技術基礎。他對建構可擴展的軟體解決方案深感興趣,並樂於探索設計與功能如何在實際應用中完美結合。

在加入 Iron Software 團隊之前,Ahmad 曾參與自動化專案與 API 整合工作,專注於提升效能與開發者體驗。

閒暇之餘,他喜歡嘗試 UI/UX 創意、為開源工具貢獻心力,並偶爾投入技術寫作與文件編寫,致力於將複雜的主題轉化為淺顯易懂的內容。

準備開始了嗎?
Nuget 下載 67,270 | 版本: 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎?

想要快速確認成果嗎? PM > Install-Package IronQR
執行範例 觀看您的 URL 轉為 QR 碼。